{"templateId":"markdown","sharedDataIds":{"sidebar":"sidebar-connectivity/docs/sidebars.yaml"},"props":{"metadata":{"markdoc":{"tagList":["admonition"]},"type":"markdown"},"seo":{"title":"Receiving notifications","siteUrl":"https://developers.booking.com","llmstxt":{"hide":false,"sections":[{"title":"Table of contents","includeFiles":["**/*"],"excludeFiles":[]}],"excludeFiles":[]}},"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 notifications, follow the instructions from the ",{"$$mdtype":"Tag","name":"a","attributes":{"href":"/connectivity/docs/notification-service/notification-service-overview"},"children":["Notification service"]}," documentation."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["A notification is sent when a status update is available regarding the Payments by Booking onboarding process or the payout configuration change request for the given property (or a group of properties)."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Upon receiving the notification, you can call the ",{"$$mdtype":"Tag","name":"a","attributes":{"href":"/connectivity/docs/payments-by-booking-onboarding-api/checking-onboarding-request-status"},"children":["Payments Configuration Status API"]}," using the ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["requestId"]}," or ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["propertyId"]}," parameter to fetch the latest status and any additional requirements."]},{"$$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":["PBB_CONFIG_UPDATE_STATUS"]}," 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":"Admonition","attributes":{"type":"success","name":"Notifications sent per property"},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["For onboarding or configuration change requests, a separate notification is sent for each individual property once its status changes."]}]},{"$$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":["propertyId"]},": Refers to the Booking.com ID of the property for which an onboarding request was sent or a configuration change was requested."]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["requestId"]},": Unique identifier for the specific onboarding or configuration change request in ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["ACCEPTED"]}," state. For bulk requests, this corresponds to the ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["request_id"]}," of an ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["ACCEPTED"]}," configuration that the given ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["propertyId"]}," is part of."]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["activationStatus"]},": Current status of the request: ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["WAITING"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["SUCCESSFUL"]},", or ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["FAILED"]},"."]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["configurationChangeAt"]},": The timestamp indicating when the status change actually occurred in the system, in ISO-8601 format (UTC)."]}]},{"$$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 and sent, in ISO-8601 format (UTC)."]}]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"activation-statuses","__idx":2},"children":["Activation statuses"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Notifications are sent for these statuses:"]},{"$$mdtype":"Tag","name":"div","attributes":{"className":"md-table-wrapper"},"children":[{"$$mdtype":"Tag","name":"table","attributes":{"className":"md"},"children":[{"$$mdtype":"Tag","name":"thead","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Status"},"children":["Status"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Meaning"},"children":["Meaning"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Action required"},"children":["Action required"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["WAITING"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["The onboarding process requires an action from the partner (e.g. ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["SUBMIT_KYC"]},")."]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Use the ",{"$$mdtype":"Tag","name":"a","attributes":{"href":"/connectivity/docs/payments-by-booking-onboarding-api/checking-onboarding-request-status"},"children":["Payments Configuration Status API"]}," to learn more."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["SUCCESSFUL"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["The property has been successfully onboarded to Payments by Booking. The configuration is now active."]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["None. You can now manage payments for this property via the ",{"$$mdtype":"Tag","name":"a","attributes":{"href":"/connectivity/docs/payments-api/understanding-the-payments-api"},"children":["Payments API"]},"."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["FAILED"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["The onboarding or configuration change request could not be completed."]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Retry or reach out to the ",{"$$mdtype":"Tag","name":"a","attributes":{"href":"https://portal.connectivity.booking.com/s/article/Contact-Us"},"children":["Connectivity Support team"]},"."]}]}]}]}]},{"$$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\": \"PBB_CONFIG_UPDATE_STATUS\",\n    \"payloadVersion\": \"1.0\"\n  },\n  \"payload\": {\n    \"timestamp\": \"2025-08-10T10:10:32Z\",\n    \"propertyId\": 10345,\n    \"requestId\": \"1f09952e-00b2-6578-abff-b723490a38d8\",\n    \"activationStatus\": \"SUCCESSFUL\"\n    \"configurationChangedAt\": \"2025-08-10T09:10:00Z\"\n  }\n}\n"},"children":[]}]},"headings":[{"value":"Receiving notifications","id":"receiving-notifications","depth":1},{"value":"Notification details","id":"notification-details","depth":2},{"value":"Activation statuses","id":"activation-statuses","depth":3}],"frontmatter":{"seo":{"title":"Receiving notifications"}},"lastModified":"2026-05-12T11:13:18.000Z","pagePropGetterError":{"message":"","name":""}},"slug":"/connectivity/docs/payments-by-booking-onboarding-api/receiving-notifications","userData":{"isAuthenticated":false,"teams":["anonymous"]},"isPublic":true}