{"templateId":"markdown","sharedDataIds":{"sidebar":"sidebar-connectivity/docs/sidebars.yaml"},"props":{"metadata":{"markdoc":{"tagList":[]},"type":"markdown"},"seo":{"title":"Receiving notifications","siteUrl":"https://developers.booking.com"},"dynamicMarkdocComponents":[],"compilationErrors":[],"ast":{"$$mdtype":"Tag","name":"article","attributes":{},"children":[{"$$mdtype":"Tag","name":"Heading","attributes":{"level":1,"id":"receiving-notifications","__idx":0},"children":["Receiving notifications"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["To start receiving credit card status notifications, follow the instructions from the ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/connectivity/docs/notification-service/notification-service-overview"},"children":["Notification service"]}," documentation."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Notifications are sent in case of an unsuccessful initial card check or in case of an invalid card. They ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["are not"]}," sent in case the card is valid or in case of any other statuses."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["For more information, see ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/connectivity/docs/credit-card-status-api/understanding-the-credit-card-status-api/#card-verification-flow"},"children":["Card verification flow"]},"."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"notification-details","__idx":1},"children":["Notification details"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["CREDIT_CARD_STATUS_UPDATE"]}," notification has the following two elements:"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Metadata"]},": Describes the payload type, UUID, as well as any other information that might be relevant for processing the notification."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Payload"]},": Represents the actionable notification content. It's different for each type of notification message."]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["metadata"]},":"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["uuid"]},": Stores the UUID for this notification. Useful when contacting Connectivity Support Executives to inquire about a given message."]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["type"]},": Type of the message."]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["payloadVersion"]},": Version of the payload JSON element. 1.0 for now, subject to change."]}]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["payload"]},":"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["eventId"]},": Refers to the ID of the notification event."]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["timestamp"]},": Timestamp in which the notification was triggered, in ISO-8601 format (YYYY-MM-DDTHH:MM:SSZ)."]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["propertyId"]},": Refers to the Booking.com ID of the property that the reservation belongs to."]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["reservationId"]},": Refers to the Booking.com ID of the hotel reservation."]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["statusValue"]},": Current status of the card: ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["INVALID_CARD"]}," or ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["INITIAL_CARD_CHECK_UNSUCCESSFUL"]},"."]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["statusTimestamp"]},": Timestamp in which the status was updated, in ISO-8601 format (YYYY-MM-DDTHH:MM:SSZ)."]}]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Example"]},":"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"header":{"controls":{"copy":{}}},"source":"{\n    \"metadata\": {\n        \"uuid\": \"FC70575E-ED0E-11EE-B5FA-B675273ACEB0\",\n        \"type\": \"CREDIT_CARD_STATUS_UPDATE\",\n        \"payloadVersion\": \"1.0\"\n    },\n    \"payload\": {\n        \"eventId\": \"365b5a8d-d116-4443-9420-fdf8b9a0b0b8\",\n        \"timestamp\": \"2025-08-10T10:10:32Z\",\n        \"propertyId\": 10345,\n        \"reservationId\": 432647264,\n        \"statusValue\": \"INVALID_CARD\",\n        \"statusTimestamp\": \"2025-08-10T10:10:32Z\"\n    }\n}\n"},"children":[]}]},"headings":[{"value":"Receiving notifications","id":"receiving-notifications","depth":1},{"value":"Notification details","id":"notification-details","depth":2}],"frontmatter":{"title":"Receiving credit card status notifications","description":"Learn how to receive and process CREDIT_CARD_STATUS_UPDATE notifications from the Credit Card Status API, including payload structure and the statuses that trigger notifications.","keywords":{"includes":["CREDIT_CARD_STATUS_UPDATE","statusValue","statusTimestamp","eventId","reservationId","payloadVersion","INVALID_CARD","INITIAL_CARD_CHECK_UNSUCCESSFUL","credit-card-status-api"]},"seo":{"title":"Receiving notifications"}},"lastModified":"2026-08-26T11:37:47.000Z","pagePropGetterError":{"message":"","name":""}},"slug":"/connectivity/docs/credit-card-status-api/receiving-notifications","userData":{"isAuthenticated":false,"teams":["anonymous"]},"isPublic":true}