{"templateId":"markdown","sharedDataIds":{"sidebar":"sidebar-connectivity/docs/sidebars.yaml"},"props":{"metadata":{"markdoc":{"tagList":["admonition"]},"type":"markdown"},"seo":{"title":"RtB 2.0 overview","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":"rtb-20-overview","__idx":0},"children":["RtB 2.0 overview"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["This section explains the Request to Book (RtB) 2.0 changes that affect your Connectivity"," ","integration with Booking.com. It is intended for engineers at connectivity providers who already"," ","integrate with the ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/connectivity/docs/request-to-book/overview"},"children":["Request to Book Connectivity API"]},"."]},{"$$mdtype":"Tag","name":"Admonition","attributes":{"type":"info","name":"What's new for existing RtB partners"},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Today, you block provider-side availability when a request becomes ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["BOOKED"]},". With RtB 2.0, you also"," ","block it when an ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["RTB"]}," request is created. Release it if the request is rejected, expires,"," ","or fails to process."]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"how-request-types-work","__idx":1},"children":["How request types work"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["RtB now supports two types of booking requests, identified by the ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["requestType"]}," field:"]},{"$$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":"Mode"},"children":["Mode"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Description"},"children":["Description"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["INQUIRY"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["The RtB 1.x flow, where a pending request does ",{"$$mdtype":"Tag","name":"em","attributes":{},"children":["not"]}," represent an availability block."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["RTB"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["The new 2.0 flow, where a pending request ",{"$$mdtype":"Tag","name":"em","attributes":{},"children":["does"]}," represent an availability hold."]}]}]}]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Key ideas:"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["In ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["INQUIRY"]}]}," mode, you continue to block availability only when the request becomes ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["BOOKED"]}," ","(reservation created)."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["In ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["RTB"]}]}," mode, you must block and release provider-side availability based on the request"," ","status. See ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/connectivity/docs/request-to-book/rtb-2.0/availability-management"},"children":["Availability management"]},"."]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"payment-and-confirmation","__idx":2},"children":["Payment and confirmation"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["In addition to blocking availability, RtB 2.0 changes how payment and confirmation work for ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["RTB"]}," ","requests:"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["When a guest sends an ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["RTB"]}," request, Booking.com ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["pre-authorizes"]}," the guest's payment method for"," ","the full amount of the stay. Funds are held but not yet captured."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["If the partner approves an ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["RTB"]}," request, Booking.com ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["immediately confirms"]}," the booking and"," ","settles payment. The guest does ",{"$$mdtype":"Tag","name":"em","attributes":{},"children":["not"]}," need to come back to finish booking after approval."," ","Partner approval directly turns the pending request into a confirmed reservation."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["For ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["INQUIRY"]}," (RtB 1.0) requests, there is no pre-authorization at request time. After the partner"," ","approves, the guest still has to return to complete payment and finalize the reservation, which"," ","they may still abandon."]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The following diagram shows how the approval flow differs between the ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["INQUIRY"]}," and ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["RTB"]}," request"," ","modes:"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"img","attributes":{"src":"/assets/inquiry-request-flow.31c4db2a2b3b9fc1c7efe3acf4d4248a2cb5758dae859eefc446d8b296b7d0f1.d44379f7.png","alt":"Approval flow for INQUIRY vs RTB requests"},"children":[]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"getting-access","__idx":3},"children":["Getting access"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Access is controlled by the ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["rtb_api_v2_enabled"]}," provider feature in Provider Portal. Enabling it is"," ","the final step of the migration. See ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/connectivity/docs/request-to-book/rtb-2.0/migration-guide"},"children":["step 7 of the migration guide"]}," for when"," ","and how to turn it on. Until it is enabled, all requests continue to use ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["requestType = INQUIRY"]},"."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["RtB 2.0 is version 2.x, so you must also send ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["X-Booking-Api-Version: 2.0.0"]}," to receive the RtB 2.0"," ","fields. See ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/connectivity/docs/request-to-book/technical-overview#versioning"},"children":["Versioning"]},"."]}]},"headings":[{"value":"RtB 2.0 overview","id":"rtb-20-overview","depth":1},{"value":"How request types work","id":"how-request-types-work","depth":2},{"value":"Payment and confirmation","id":"payment-and-confirmation","depth":2},{"value":"Getting access","id":"getting-access","depth":2}],"frontmatter":{"title":"RtB 2.0 overview","description":"Overview of the Request to Book (RtB) 2.0 changes for Connectivity providers, including the new INQUIRY and RTB request modes and how payment and confirmation differ between them.","keywords":{"includes":["RTB","INQUIRY","requestType","rtb","inquiry","RtB 2.0","pre-authorization","VCC"]},"seo":{"title":"RtB 2.0 overview"}},"lastModified":"2026-07-29T11:41:00.000Z","pagePropGetterError":{"message":"","name":""}},"slug":"/connectivity/docs/request-to-book/rtb-2.0/overview","userData":{"isAuthenticated":false,"teams":["anonymous"]},"isPublic":true}