Receiving notifications

To start receiving credit card status notifications, follow the instructions from the Notification service documentation.

Notifications are sent in case of an unsuccessful initial card check or in case of an invalid card. They are not sent in case the card is valid or in case of any other statuses.

For more information, see Card verification flow.

Notification details

The CREDIT_CARD_STATUS_UPDATE notification has the following two elements:

Metadata: Describes the payload type, UUID, as well as any other information that might be relevant for processing the notification.
Payload: Represents the actionable notification content. It's different for each type of notification message.

metadata:

uuid: Stores the UUID for this notification. Useful when contacting Connectivity Support Executives to inquire about a given message.
type: Type of the message.
payloadVersion: Version of the payload JSON element. 1.0 for now, subject to change.

payload:

eventId: Refers to the ID of the notification event.
timestamp: Timestamp in which the notification was triggered, in ISO-8601 format (YYYY-MM-DDTHH:MM:SSZ).
propertyId: Refers to the Booking.com ID of the property that the reservation belongs to.
reservationId: Refers to the Booking.com ID of the hotel reservation.
statusValue: Current status of the card: INVALID_CARD or INITIAL_CARD_CHECK_UNSUCCESSFUL.
statusTimestamp: Timestamp in which the status was updated, in ISO-8601 format (YYYY-MM-DDTHH:MM:SSZ).

Example:

{
    "metadata": {
        "uuid": "FC70575E-ED0E-11EE-B5FA-B675273ACEB0",
        "type": "CREDIT_CARD_STATUS_UPDATE",
        "payloadVersion": "1.0"
    },
    "payload": {
        "eventId": "365b5a8d-d116-4443-9420-fdf8b9a0b0b8",
        "timestamp": "2025-08-10T10:10:32Z",
        "propertyId": 10345,
        "reservationId": 432647264,
        "statusValue": "INVALID_CARD",
        "statusTimestamp": "2025-08-10T10:10:32Z"
    }
}