Accommodation pricing FAQs

• base – The raw cost before any charges.
• book – The legally required display price (base + included charges). Only in accommodations/search and accommodations/availability.
• total – The full amount payable, including non-conditional charges. It appears in orders/preview.

It's okay to display the base price as long as you display the extra charges and total price as well.

What you should never do is advertise the base price without any other visible detail.

In the extra_charges object returned:

• When using accommodations/availability endpoint - included, excluded, conditional charges.
• When calling the orders/preview in the booking phase - non_conditional charges.

• Include products and extra_charges in the extras parameter for /accommodations/search and accommodations/availability endpoint.
• Always call /orders/preview before confirming a booking to get the final amount.

The book is only returned during search and availability flows and no longer needed when previewing the order. At booking stage, the user must be shown the total cost.

• Check the chargeable_online field in the /orders/preview response, you will see the emount there.
• You should load the chargeable_online amount onto your Virtual Credit Card (VCC). This value represents the portion of the total amount that Booking.com charges online.

Rely on /orders/preview total price and consider:

• Labelling search and availability prices as “estimated”.
• Explaining that final prices may vary slightly due to taxes, rounding, or regional policies.

• included – Already part of the book price.
• excluded – Mandatory but not included in book; shown separately until checkout.
• conditional – Charges that only apply under certain conditions.
• non_conditional – Final confirmed charges included in the total at booking time.

• Check the Extra charges calculation guide to understand how charges are calculated.
• Find most common examples in the Pricing use cases guide.

“The final price may vary slightly due to local taxes, currency rounding, or policy rules.”

This improves transparency and reduces confusion.

Yes, you can use base and total for analytics, but do not use cached prices for real-time booking flows.

• Use book for display in search.
• Use total for booking confirmation.
• Ensure your flow matches the local booker protection laws.

The /orders/preview response is the final and authoritative source of pricing.

Possible reasons:

• No extra charges apply for this property.

• You didn’t request extra_charges in the extras parameter.

In /orders/preview, excluded_charges are merged into the non_conditional charges, that are part of the total price (as they become final at booking time).

They remain separate only during search and availability for transparency.

The difference is due to Booking.com charging online only part of the cost, but not the full amount.

• Always load the exact chargeable_online amount on the VCC.

• If there’s a small rounding issue, allow a buffer (e.g., +2%) but never exceed total.