Price Check

šŸ’ø Price Check API

Hotel prices are dynamic and can change at any time. To prevent booking failures due to price fluctuations, it's essential to pass the correct price during the booking process.

The Price Check API verifies whether the price for a given recommendationId is still valid or has changed.

šŸ” Why Use This API?

  • Ensures the price is up-to-date before booking
  • Helps avoid failed bookings due to outdated pricing
  • Promotes transparency with end-users by allowing confirmation on price change

Price Check: Response Keys

KeyDescription
priceChangeDataDetails of any price change found when the rate was repriced. It tells you whether the price differs from the one shown in Rooms and Rates, and by how much. Show this to the customer before they continue with /book.
isPriceChangedtrue if the repriced price differs from the price the customer selected, false if it is unchanged.
oldPricePrice of the rate when it was returned in Rooms and Rates, in the response currency.
newPriceCurrent price of the rate after reprice, in the response currency.
āš ļø

If there's a price change, it’s recommended to:

  • Notify the user
  • Proceed with booking only after obtaining their consent

Attempting to book with an outdated price will result in booking failure.

Usage:

If the price is unchanged, you can go ahead with /book.
If the price has changed, show the new price to the customer and get their approval first. Do not continue with the old price.
Use the new price and the latest cancellation policy from the Price Check response for the rest of the flow, not the values from Rooms and Rates.

šŸ“˜ API Reference: Price Check API Documentation


Did this page help you?