{"templateId":"markdown","sharedDataIds":{"sidebar":"sidebar-connectivity/docs/reconciliation-api/sidebars.yaml"},"props":{"metadata":{"markdoc":{"tagList":["partial"]},"type":"markdown"},"seo":{"title":"Understanding the Reconciliation API","siteUrl":"https://developers.booking.com"},"dynamicMarkdocComponents":[],"compilationErrors":[],"ast":{"$$mdtype":"Tag","name":"article","attributes":{},"children":[{"$$mdtype":"Tag","name":"Admonition","attributes":{"type":"warning","name":"This API is in closed beta"},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The API functionality is in closed beta phase. Currently, the closed beta is available only for select providers. Make sure to direct any questions during the beta phase to your Booking.com contact person via the appropriate channels."]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":1,"id":"understanding-the-reconciliation-api","__idx":0},"children":["Understanding the Reconciliation API"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The Reconciliation API helps ensure accuracy and transparency in financial transactions between Booking.com and its partners by providing a payout report at the reservation level for all bank transfers (including Stripe) made from Booking.com to the partners."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["A payout report contains all the reservations and other transactions that contribute to partners' payouts, as well as breakdowns regarding commission, taxes, and other items."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["This process is also known as the reconciliation process. It's carried out by partners to match payouts issued to them against services provided. The reconciliation process addresses discrepancies, clarifies payouts, and supports partners in confirming they have received the right amount for accounting purposes, tax filing, and other financial reporting requirements."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["This API is supported for both single-property owners and multi-property owners."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"what-is-possible-with-the-reconciliation-api","__idx":1},"children":["What is possible with the Reconciliation API?"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["✔ ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/connectivity/docs/reconciliation-api/requesting-payout-report"},"children":["Request a payout report to be generated"]}," by selecting applicable ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/connectivity/docs/reconciliation-api/getting-filters-for-legal-entity-id"},"children":["filters"]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["✔ ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/connectivity/docs/reconciliation-api/checking-the-status-and-downloading-the-payout-report"},"children":["Check the status of the report"]}," and receive ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/connectivity/docs/reconciliation-api/receiving-notifications"},"children":["a notification"]}," once it's ready"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["✔ ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/connectivity/docs/reconciliation-api/checking-the-status-and-downloading-the-payout-report"},"children":["Download a completed report"]}," via a download link"]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"main-url-and-use-of-shortened-endpoint-paths","__idx":2},"children":["Main URL and use of shortened endpoint paths"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The Reconciliation API's main URL is ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["https://payments-api.booking.com"]},". All shortened endpoint paths imply that you must add the main URL."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"authentication","__idx":3},"children":["Authentication"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The Reconciliation API uses the same ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/connectivity/docs/authentication"},"children":["authentication methods"]}," as other APIs."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"contact-us","__idx":4},"children":["Contact us"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Need help integrating with the Reconciliation API? The experts in our ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"https://portal.connectivity.booking.com/s/article/Contact-Us"},"children":["Connectivity Support team"]}," are here to help."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Do you want us to improve this page?  Click ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Yes"]}," | ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["No"]}," in the ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Was this page helpful?"]}," box at the bottom of this page."]}]},"headings":[{"value":"Understanding the Reconciliation API","id":"understanding-the-reconciliation-api","depth":1},{"value":"What is possible with the Reconciliation API?","id":"what-is-possible-with-the-reconciliation-api","depth":2},{"value":"Main URL and use of shortened endpoint paths","id":"main-url-and-use-of-shortened-endpoint-paths","depth":2},{"value":"Authentication","id":"authentication","depth":2},{"value":"Contact us","id":"contact-us","depth":2}],"frontmatter":{"excludeFromSearch":true,"sidebar":{"path":"sidebars.yaml"},"seo":{"title":"Understanding the Reconciliation API"}},"lastModified":"2026-08-04T10:27:27.000Z","pagePropGetterError":{"message":"","name":""}},"slug":"/connectivity/docs/reconciliation-api/understanding-the-reconciliation-api","userData":{"isAuthenticated":false,"teams":["anonymous"]},"isPublic":true}