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.