PCI Booking offers customers the ability to receive status notifications on creating a card capture form requests sent to a specific URL. The callback API should have the following signature. The callback will be sent each time there is a status change.
- Parameters
CaptureCardRequestID
: The ID of the card request in PCI Booking (string). For example,9e4fac88bab14e01b5befe540
.CaptureCardRequestStatus
: The status of the tokenization in the card capture form (string). See a complete list of status codes below. For example,OK
CardUri
: The card token in PCI Booking (string). For example,https://service.pcibooking.net/api/payments/paycard/G54Cvv0GZddE4TTr44mHj12DssAzb5Dp
.
Below is an example of the request body that will be sent to your callback application:
{
"CaptureCardRequestID": "uC1efRTOpU4p3hmhH7fbY3J6A9LYL3j5",
"CaptureCardRequestStatus": "OK",
"CardUri": "https://service.pcibooking.net/api/payments/paycard/G54Cvv0GZddE4TTr44mHj12DssAzb5Dp"
}
Statuses description
Status | Value | |
---|---|---|
Store failed | Failure | General error - The card storage failed |
Store failed due to bad data | BadData | The card storage failed since the customer entered not valid information. E.g. entered Visa, which wasn’t on the supported card types |
Card stored | OK | Card was stored successfully. The status response will include a CardUri parameter which will contain the PCI Booking token. |
Expired | Expired | The request passed the TTL time |