Sandbox Test Scenarios¶
Rates in the sandbox (development environment, https://hotels.sandbox.bookitapi.com) are test rates. Prices, availability and cancellation terms are not the properties' real rates and do not match production.
A fixed set of properties reproduces specific quote and booking outcomes, so you can check how your integration handles them before going live. Search for one of the properties below, quote any of its packages and book it. The outcome is the same for every package of the property.
Every other property quotes with no changes and books successfully.
Scenarios at a glance¶
| Scenario | Search | Quote | Book |
|---|---|---|---|
| Price change | Returns packages | 200 OK, higher totalPrice, changes contains PriceChanged | Succeeds |
| Refundability change | Returns packages | 200 OK, opposite isRefundable, changes contains CancellationPolicyChanged | Succeeds |
| Refundability date change | Returns packages | 200 OK, refundability date one day earlier, changes contains CancellationPolicyChanged | Succeeds |
| Sold out | Returns packages | 404 Not Found, ROOM_SOLD_OUT | — |
| Booking failure | Returns packages | 200 OK, no changes | 409 Conflict, BOOKING_FAILED |
| Any other property | Returns packages | 200 OK, no changes | Succeeds |
Price change¶
The quote returns a higher room.package.totalPrice than search, and room.package.changes contains PriceChanged. The booking succeeds at the quoted price.
| Property ID | Name | City | Country |
|---|---|---|---|
R:101996671 | Essential by Dorint Interlaken | Interlaken | CH |
R:4623245 | The Cosmopolitan Of Las Vegas | Las Vegas | US |
R:3388994 | Park Plaza London Westminster Bridge | London | GB |
Refundability change¶
The quote returns the opposite refundability from search: a refundable package quotes as non-refundable, and a non-refundable package quotes as refundable. room.package.changes contains CancellationPolicyChanged. The booking succeeds with the quoted cancellation terms.
| Property ID | Name | City | Country |
|---|---|---|---|
R:216994 | The Tower Hotel, by Thistle | London | GB |
R:950543 | Martinique New York on Broadway, Curio Collection by Hilton | New York | US |
R:228706 | Keio Plaza Hotel Tokyo | Tokyo | JP |
Refundability date change¶
For a refundable package, the quote returns a refundability date one day earlier than search (cancellationPolicy.fullRefundability.to, and every fees[].since when the cancellation fee schedule is returned). room.package.changes contains CancellationPolicyChanged. Non-refundable packages quote with no changes. The booking succeeds with the quoted cancellation terms.
| Property ID | Name | City | Country |
|---|---|---|---|
R:700820 | London Marriott Hotel Grosvenor Square | London | GB |
R:43769 | Amsterdam Marriott Hotel | Amsterdam | NL |
R:222075 | Westgate New York Grand Central | New York | US |
Sold out¶
Search returns packages for the property, but the quote fails with 404 Not Found and the error ROOM_SOLD_OUT because the room is no longer available. No packageBookingId is returned, so the package cannot be booked. Search keeps returning these packages, and every quote fails the same way.
| Property ID | Name | City | Country |
|---|---|---|---|
R:7268270 | Le Meridien New York, Central Park by Marriott | New York | US |
R:221135 | Pan Pacific Singapore | Singapore | SG |
R:93432985 | 1 Hotel Mayfair | London | GB |
Booking failure¶
Search and quote succeed and the quote reports no changes. The booking fails with 409 Conflict and the error BOOKING_FAILED, and no reservation is created. The packageBookingId cannot be used again; another attempt starts from a new quote.
| Property ID | Name | City | Country |
|---|---|---|---|
R:1207722 | L’Hôtel du Collectionneur Paris | Paris | FR |
R:18085376 | Hyatt Regency Amsterdam | Amsterdam | NL |
R:66164978 | CIVILIAN Hotel | New York | US |