Last updated

Third-party inventory rates FAQs

Find answers to the most common questions regarding TPI, Sell and Net rates.


General

What are third-party inventory (TPI) rates?
  • TPI rates are accommodation offers sourced from external providers through Booking.com’s third-party inventory system.
  • These rates may come with different pricing, policies, or confirmation processes compared to direct Booking.com listings.
Why am I not seeing TPI rates in my search or availability responses? There are several possible reasons:
  • You are not onboarded for TPI.
  • You are sending a multi-room search (TPI supports single-room searches only).
  • The extras field is missing or does not include "products".
  • There may be no available TPI rooms for the selected date and accommodation.
What is the difference between TPI Net rates and Commissionable rates?
  • Commissionable (Sell) rates - Include a margin for your business. You collect payment from the traveller.
  • Net rates - Exclude margin; you are responsible for setting the final price.
What are the benefits of using Net rates?
  • Pricing flexibility - Net rates allow you to apply your own mark-ups, giving you greater autonomy in promoting and selling accommodation options, while directly optimising your profitability. You can adjust pricing in line with your overall strategy, market conditions, and demand.
  • Real-time reporting - Real-time reporting is available, providing maximum visibility and control over your pricing strategy.
  • Improved price competitiveness - Greater price competitiveness and the ability to participate in promotional offers enable you to further enhance your value proposition to customers.
  • New growth opportunities - Net rates can be easily incorporated into opaque package deals that include other travel services, such as flights and car hire.
  • Seamless integration - Net rates are available via the latest version of the Demand API (v3.1 and above), enabling seamless integration with advanced technology.

Booking process

How do I book a TPI product? Use the standard booking flow:
  • Retrieve the product rates using the accommodations/availability endpoint.
  • Validate the product and retrieve final details using orders/preview.
  • Confirm the booking via orders/create, including the appropriate payment method.
Can I use any payment method when booking a TPI rate? No. Supported payment methods depend on the rate type:
  • Net rates - Require a Virtual Credit Card (VCC).
  • Sell rates - Require Credit Card or Virtual Credit Card (VCC).
What should I include in the `orders/create` request for TPI bookings? Include:
  • The selected product ID.
  • Traveller details.
  • Order token.
  • Correct payment method.

Refer to the Orders creation guide for more details.

What does "method_required" in the orders/preview response mean?

The field method_required under general_policies in the Orders/preview response identifies whether a payment method is needed in the order.

The method_required can be:

  • True -- This means that a payment method (such as a credit card) is mandatory - This is the option we need to use in the requests for TPI rates.

  • False -- The product does not require a credit card for booking. This is not supported for TPI rates.

Refer to the Payment use cases for orders/preview response examples.

Confirmation & guest experience

What booking information should I show to travellers?

For TPI bookings (for both Commissionable Sell and Net rates), clearly display:
  • The pincode.
  • The confirmation number.
  • The check-in number.

These are required for the traveller to check in and for customer support validation.

Where can I find the check-in and confirmation numbers?

These are included in the response from the orders/create endpoint under third_party_inventory.

Cancellations

Can I cancel a TPI booking? It depends on the cancellation policy. Use the /orders/cancel endpoint only when:
  • The policy is flexible and cancellation is allowed.
  • Do not attempt cancellation for non-refundable or partially refundable products — doing so will return a 500 error.
Where can I find the cancellation policy for a TPI rate?

Check the cancellation policy in:

  • The accommodations/availability response (policies.cancellation)
  • The orders/preview response.

Troubleshooting

I get a 500 error when cancelling a booking. What does it mean?

This typically indicates the booking is non-refundable. Always check the cancellation policy before calling /orders/cancel.

I'm getting an "invalid payment method" error when booking. What should I do?

Ensure the correct payment method is used:

  • Use VCCs for Net rates.
  • Use Credit Cards or VCCs for Commissionable Sell rates.
VCCs are not being accepted — how can I fix this?

Ensure your request includes "credit_card_required": true in the payment configuration of your orders/create call.

Which Affiliate ID should I use for TPI bookings? Use:
  • Your regular AID for Sell rates.
  • Your dedicated AID for Net rates.

Contact your Booking.com account manager if you’re unsure.