Sell rates quick guide

Learn how to get the best value to your travellers by having Sell rates enabled.

Pre-requisites

To enjoy the benefits of Sell rates, you must first meet these requirements:

How to retrieve Sell rates?

You can retrieve Sell rates when using our accommodation endpoints.

Depending on the sort of integration you are implementing, you should use different endpoints:

Requirements for retrieving Sell Rates

To retrieve Sell rates, ensure that your requests:

Refer to our examples for details on how to implement each of these requirements in your requests.

Search for content

If you are only retrieving our content and performing the look and book with whilelabel ("Content only" integration), then you must call our accommodation/search endpoint.

• You receive these rates on the branded landing platforms of Booking.com tagged as “Partner Offer” in our user interface.

Then you can market it using whitelabel.

Example:

Within the API you receive the best price as search output, which could be either from a third-party or Booking.com inventory based on rates ranking.

You can identify the use of Sell rates by means of the third_party_inventory tag returned in the response.

Examples:

{
"booker": {
  "country": "nl",
  "platform": "desktop"
},
"checkin": "2024-12-15",
"checkout": "2024-12-18",
"city": -2140479,
"extras": [
  "products"
],
"guests": {
  "number_of_adults": 3,
  "number_of_rooms": 1
}
}

Search, look and book

If you are implementing an end-to-end booking experience (Search, look and book integration), then you must cover the full Accommodation API flow:

• Search: Use the accommodation/search endpoint to find available accommodations based on user preferences. (Refer to the previous section for more details)
• Look: Retrieve real-time information on room availability and rates with the accommodation/availability endpoint.
• Preview: Use the order/preview endpoint to get a detailed summary before confirming a booking.
• Book: Complete the booking process using the order/create endpoint. Ensure that the payment method and timing are set correctly.

In each of these endpoints you can identify whether a product price comes from Sell rates or not, by checking the third_party_inventory tag. You can find this tag within the successful response of the calls.

Examples:

Look at availability

Use the accommodation/availability endpoint to provide real-time information about the availability and prices of all rooms and rates offered by the selected accommodation.

"accommodation": -2140479,
"booker": {
  "country": "nl",
  "platform": "desktop"
},
"checkin": "2024-12-15",
"checkout": "2024-12-18",
"extras": [
  "extra_charges"
],
"guests": {
  "number_of_adults": 3,
  "number_of_rooms": 1
}
}'

Preview the booking

For the booking, you need to use the order/preview endpoint first.

{
"booker": {    
    "country": "nl",    
    "platform": "desktop",    
    "travel_purpose": "leisure"
},    
"currency": "EUR",    
"accommodation": {    
    "id": -2140479,    
    "checkin": "2024-12-15",  
    "checkout": "2024-12-18",  
        "products": [    
            {    
                "id": "tpi-f621534d2037f346ff4b80c090072866",    
                "allocation": {    
                    "number_of_adults": 3    
                } 
}

Create the booking

The final step in the full booking experience is to use the order/create endpoint, to finish the payment.

{
"accommodation": {
  "label": "sample label",
  "products": [
  {
    "id": "tpi-8995692365a24512a9b855be0e80b36d"
  }
],
"remarks": {
  "estimated_arrival_time": {
    "hour": 12
  },
  "special_requests": "no"
}
},
"booker": {
"address": {
  "address_line": "road-1, house-2",
  "city": "amsterdam",
  "country": "nl",
  "post_code": "1111AB"
},
"company": "aaaaa",
"email": "name.family@email.com",
"language": "en-gb",
"name": {
  "first_name": "n.a.m.e",
  "last_name": "f.a.m.i.l.y"
},
"telephone": "12345678"
},
"order_token": "eyJhbGciOiJIUzI1NiJ9.eyJwIjp7ImFjY29tbW9kYXRpb24iOnsiaWQiOjI0ODk2MjMsImNoZWNraW4iOiIyMDI0LTEyLTE1IiwiY2hlY2tvdXQiOiIyMDI0LTEyLTE4IiwiY3VycmVuY3kiOiJUSEIiLCJwcm9kdWN0cyI6W3siaWQiOiJ0cGktZjYyMTUzNGQyMDM3ZjM0NmZmNGI4MGMwOTAwNzI4NjYiLCJhbGxvY2F0aW9uIjp7ImNoaWxkcmVuIjpbXSwibnVtYmVyX29mX2FkdWx0cyI6MX0sInRvdGFsX3ByaWNlIjoyMTk4Ljk3fV19LCJib29rZXIiOnsiY291bnRyeSI6Im5sIiwicGxhdGZvcm0iOiJkZXNrdG9wIiwidHJhdmVsX3B1cnBvc2UiOiJsZWlzdXJlIn0sImJvb2tlcl9jdXJyZW5jeSI6IkVVUiJ9LCJhdWQiOiIvb3JkZXJzL2NyZWF0ZSIsImV4cCI6MTcyNDkyNDk5N30.64SF7j3sBneoTsLQkig7uJi-HnaY1SZVdsUHrSTRp_c",
"payment": {
  "card": {
    "cardholder": "CARD HOLDER",
    "cvc": 111,
    "expiry_date": "xxxx-xx",
    "number": "xxxxxxxxxxxxxxxx",
    "authentication":{
        "sca_exemption":"virtual"
        }
},
"include_receipt": true,
"method": "card",
"timing": "pay_online_now"
}
}

Your order ids

A successful order/create response returns the following ids:

• Order ID: This is the booking number that you should use to cancel an order and also for Customer Services in case any support is needed.
• Pincode: This is a shorter number that identifies your booking and is handy when contacting Customer Services. It is also included in the booking confirmation message.
• Reservation ID: This is a v2 legacy. You should only use this if you need to access orders created using V2 after you have migrated your integration to V3.

Example of confirmation message for a third-party inventory booking (Partner offer), with order id and pin code:

Cancellations

Keep in mind that if you need to cancel a booking for a third-party inventory accommodation, you must follow the same instructions and best practices, that those defined for other sort of accommodations.

• Refer to the Handling cancellations guide for more details.
• Use the /orders/cancel endpoint to proceed with cancellations.