Integrating Commissionable TPI rates

Learn everything about Commissionable third-party (TPI) Sell rates, and how to retrieve and book them using the Demand API.

About Commissionable third-party rates

These rates are commissionable rates sourced from a third-party inventory (TPI). Commissionable third-party rates are made available when they offer a better price than direct Booking.com inventory, helping you stay competitive.

These rates are integrated as "Sell rates" via the Demand API and sourced from other brands within Booking Holdings.

Key benefits

Some benefits of enabling Commissionable third-party sell rates:

Who is this guide for?

You should use this guide if you:

• Integrate with Demand API v3.1.
• Are authorised to use pay_online_now with supported payment methods (Credit Cards or Virtual Credit Cards).
• Are implementing one of the following flows:
  • Search and look (Commissionable sell rates with whitelabel)
  • Search, look and book
  • Post-booking

Depending on the sort of integration you are implementing, follow the dedicated processes to make these rates bookable.

Implementing Search and look flow

To support the Search and look integration, implement this flow including booking with whitelabel.

Step 1 and 2 - Search and look for Commissionable TPI rates

In the accommodations/search and availability responses, Commissionable TPI rates are identified as "Sell" rates.

• Check the inventory object and the third_party_inventory.type= "sell" field.
• The returned products represent the best price for your criteria (e.g. one room, pay online now).
  • The product with Sell rate is the first available retrieved in the availability results for the same room, cancellation policy, and meal plan.
• Accommodation URLs and deep links are returned in the availability response, not in search.

Example of availability response:

{
  "request_id": "01j6en0kkx6ve7eyd8nmh6knaz",
  "data": {
    "id": 2489623,
    "currency": "EUR",
    "deep_link_url": "booking://hotel/2489623?affiliate_id=1234567&checkin=2025-12-15&checkout=2025-12-18",
    "products": [
      {
        "id": "tpi-f621534d2037f346ff4b80c090072866",
        "deal": null,
        "inventory": {
          "third_party": true,
          "type": "sell"
        },
        "maximum_occupancy": {
          "adults": 3,
          "children": null,
          "total": 3
        },
        "number_available_at_this_price": 1,
        "policies": {
          "cancellation": {
            "free_cancellation_until": "2025-12-13T16:59:59+00:00",
            "type": "free_cancellation"
          },
          "meal_plan": {
            "meals": [],
            "plan": "no_plan"
          },
          "payment": {
            "prepayment_required": true,
            "timings": [
              "pay_online_now"
            ]
          }
        },
        "price": {
          "book": 58.03,
          "total": 58.03
        },
        "room": 248962301,
        "third_party_inventory": true
      },
      ...
    ],
    "recommendation": null,
    "url": "https://www.booking.com/hotel/th/kallapangha-resort.html?aid=1234567&checkin=2024-12-15&checkout=2024-12-18&no_rooms=1&group_adults=1&selected_currency=EUR"
  }
}

Step 3 - Booking Commissionable TPI rates with whitelabel

This type of integration requires performing the book part of the flow by sending the traveller to Booking.com landing platform.

In these cases, Commissionable TPI rates appear on Booking.com’s branded landing pages and are tagged as “Partner Offer” in the user interface.

You can then market these offers via your whitelabel setup:

Implementing Search, look and book flow

To support a full TPI booking flow (Search, look and book integration), implement the complete accommodation flow including preview and create the order.

Step 3 and 4 - Previewing and booking Commissionable TPI rates

To book Sell rates, you must meet these requirements:

• Follow the standard accommodation booking flow:

1. Call orders/preview endpoint to get final pricing and policies.
2. Use orders/create endpoint to confirm the booking.

• Ensure you specify the payment method in the request (either Credit card or VCC)

See the Step-by-step TPI rates guide for implementation details.

Post booking

For post-booking tasks guidelines on reporting TPI rates, or cancelling TPI bookings, refer to the dedicated guide.

Commissionable TPI rates integration best practices

Follow these recommendations for a smooth and effective Commissionable rates integration:

Troubleshooting

Here are some common issues you might encounter and how to resolve them:

Next steps

Want to optimise your integration? Explore these additional resources: