{"templateId":"markdown","sharedDataIds":{"sidebar":"sidebar-connectivity/docs/sidebars.yaml"},"props":{"metadata":{"markdoc":{"tagList":["admonition"]},"type":"markdown"},"seo":{"title":"Version history","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":"version-history","__idx":0},"children":["Version history"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["This page lists the supported versions and a description of their behaviour."," ","A newer version includes the behaviour of all previous versions."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"version-11","__idx":1},"children":["Version 1.1"]},{"$$mdtype":"Tag","name":"Admonition","attributes":{"type":"success","name":"Specifying the version to use"},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["By default, the API returns the latest version (currently 1.1) response format. If you want to keep the previous behavior until you're ready to migrate, specify ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["accept-version: 1.0"]}," in your request header."]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["This version introduces a few new, backward‑compatible fields so partners can see a more detailed payout and charges breakdown for Payments by Booking:"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Separated commissions vs payment charges: ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["partner_payout.commissions_and_charges.breakdown"]}," includes distinct ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["total_commissions"]}," and ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["total_charges"]},"."]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Applicable rate on charges (",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["applicable_rate"]},"): exposes the actual rate (e.g. tax %) used to calculate each charge."]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Applicable type on charges (",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["applicable_type"]},"): indicates how a charge applies (e.g. per person or per night)."]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Bank transfer indentifier to track the payout: a ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["bank_transfer_reference"]}," field is included per bank transfer payout so partners can tie payout information in the API to actual bank transfer payouts."]}]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The version also introduces a ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["payment_tags"]}," field that indicates the payment type and collection method for a reservation (e.g. ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["PAYMENTS_BY_BOOKING"]},")."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Note"]},": a new ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["customer_credit_cards"]}," field is reserved for future Payments API updates."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["For more information, see ",{"$$mdtype":"Tag","name":"a","attributes":{"href":"/connectivity/docs/payments-api/managing-payment-and-payout-details"},"children":["Managing payment and payout details"]},"."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"version-10","__idx":2},"children":["Version 1.0"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["This is the initial version."]}]},"headings":[{"value":"Version history","id":"version-history","depth":1},{"value":"Version 1.1","id":"version-11","depth":2},{"value":"Version 1.0","id":"version-10","depth":2}],"frontmatter":{"seo":{"title":"Version history"}},"lastModified":"2026-05-21T11:03:38.000Z","pagePropGetterError":{"message":"","name":""}},"slug":"/connectivity/docs/payments-api/version-history","userData":{"isAuthenticated":false,"teams":["anonymous"]},"isPublic":true}