# Receiving notifications

To start receiving credit card status notifications, follow the instructions from the [Notification service](/connectivity/docs/notification-service/notification-service-overview) 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](/connectivity/docs/credit-card-status-api/understanding-the-credit-card-status-api/#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"
    }
}
```