During the process, a booking goes through different stages (BookingStage):
priceCheck: Initial price verification where you get available rooms and rates
priceConfirmed: Price matches what's available on the website. Wait for startBooking stage to proceed with the booking process.
roomSelection: If price doesn't match or you're skipping confirmation (skipConfirmation=true), you must select a priceId from the availableRooms, and make a new request to /Booking/prices/confirm endpoint. Alternatively, you can cancel the booking
startBooking: Beginning of booking process where it is actually executed the process of booking the room based on initial arguments
processingBooking: Processing the booking is a middle stage where it is either awaiting some inputs or processing the booking
finalPriceConsent: Where you are required to confirm the final price of the booking
awaitingTdsChallenge: Where you are required to complete the 3D Secure challenge (from the rendered HTML)
bookingConfirmed: This is the final stage reached when you hace confirmed the booking
Get initial room prices for a given search criteria. Use requestId (up to 1 hour) from response to confirm availability and price at /Booking/prices/confirm.
{"requestId":"57487287-f002-4ab7-89b4-8386f7cb1b30","result":{"hotelId":"f77c096f-6ca2-4b91-8b18-00004ad8429e","checkIn":"2025-02-15","nights":1,"guests":2,"rooms":[{"name":"Standard Double Room","capacity":2,"rates":[{"name":"Advance Purchase","baseRate":{"value":57300,"currencyCode":"gbp"},"taxes":[],"occupancy":2,"breakfastIncluded":false,"refundable":{"available":false},"rule":"default","fees":[],"description":"Deposit Required<>Room only rate, inclusive of VAT.","priceId":"c03b53345d2ee51a"},{"name":"Flexible Rate","baseRate":{"value":60000,"currencyCode":"gbp"},"taxes":[],"occupancy":2,"breakfastIncluded":false,"refundable":{"available":true,"untilDate":"2025-02-13"},"rule":"default","fees":[],"description":"Guaranteed with Credit Card<>Room only rate, inclusive of VAT and excluding 5% rooms service charge.","priceId":"bcb202f07bb63175"}],"description":"Large windows overlooking the courtyard or with city views. The perfect urban retreat.","images":[{"type":"Link","name":"CRS","url":"https://gc.synxis.com//hotel/35787/Images/Room/standard_double.jpg"},{"type":"Link","name":"VScape","url":"https://d321ocj5nbe62c.cloudfront.net/imageRepo/7/0/164/137/931/1._Standard_S.jpg"}]},"..."]}}
Confirm if the room is available, the price is correct. If room is not available, the response will include the available rooms with new prices (priceIds). When room not available, call this endpoint again with the new bookingPriceId from availableRooms response or cancel the booking.
However, you can also skip price confirmation by setting skipConfirmation=true in the request. This will cause this endpoint to not confirm the price in the website, and respond with all available rooms instead.
Note: You can make a request to this endpoint up to 1 hour for the same requestId, after response from /Booking/prices. Although, in the eventuality of selecting a new priceId from the availableRooms of this endpoint's response, you can use the same requestId in the request.
{"bookingId":"80c63970-05ae-4920-b7c4-563d27bd63af","clientId":"26c177b8-5233-4f17-92b4-4573ef9f9394","state":"pending","stage":"priceConfirmed","createdAt":"2025-02-03T12:51:35.927Z","succeededAt":null,"failedAt":null,"error":null,"selectedRooms":[{"name":"Standard Double Room","description":"Queen-size bed and cosy sitting area with walk-in shower. Large windows overlooking the courtyard or with city views. The perfect urban retreat.","images":[{"type":"Link","name":"Image","url":"https://gc.synxis.com//hotel/35787/Images/Room/standard_double.jpg"},{"type":"Link","name":"Image","url":"https://d321ocj5nbe62c.cloudfront.net/imageRepo/7/0/164/137/931/1._Standard_S.jpg"}],"rates":[{"name":"Advance Purchase","description":"Room only rate, inclusive of VAT.","baseRate":{"value":54100,"currencyCode":"gbp"},"priceId":"92653aeb66b5c7b7","taxes":[],"breakfastIncluded":false,"allInclusive":false,"refundable":{"available":false},"rule":"default","fees":[]}]}]}
Room available (stage is "priceConfirmed"), wait till booking can start (stage is "startBooking")
{"bookingId":"80c63970-05ae-4920-b7c4-563d27bd63af","clientId":"26c177b8-5233-4f17-92b4-4573ef9f9394","state":"pending","stage":"roomSelection","createdAt":"2025-02-03T12:51:35.927Z","succeededAt":null,"failedAt":null,"error":{"category":"system","code":"PriceNotFound","message":"Price not found by `bookingPriceId`. Use a different `priceId` from `availableRooms`","object":"error"},"availableRooms":[{"name":"Standard Double Room","description":"Queen-size bed and cosy sitting area with walk-in shower. Large windows overlooking the courtyard or with city views. The perfect urban retreat.","images":[{"type":"Link","name":"Image","url":"https://gc.synxis.com//hotel/35787/Images/Room/standard_double.jpg"},{"type":"Link","name":"Image","url":"https://d321ocj5nbe62c.cloudfront.net/imageRepo/7/0/164/137/931/1._Standard_S.jpg"}],"rates":[{"name":"Advance Purchase","description":"Room only rate, inclusive of VAT.","baseRate":{"value":54100,"currencyCode":"gbp"},"priceId":"92653aeb66b5c7b7","taxes":[],"breakfastIncluded":false,"allInclusive":false,"refundable":{"available":false},"rule":"default","fees":[]},{"name":"Flexible Rate","description":"Room only rate, inclusive of VAT and excluding 5% rooms service charge.","baseRate":{"value":60000,"currencyCode":"gbp"},"priceId":"bcb202f07bb63175","taxes":[],"breakfastIncluded":false,"allInclusive":false,"refundable":{"available":false},"rule":"default","fees":[]}]}]}
Booking not available, needing room selection, please notice the error message in JSON
{"bookingId":"80c63970-05ae-4920-b7c4-563d27bd63af","clientId":"26c177b8-5233-4f17-92b4-4573ef9f9394","state":"pending","stage":"roomSelection","createdAt":"2025-02-03T12:51:35.927Z","succeededAt":null,"failedAt":null,"error":null,"availableRooms":[{"name":"Standard Double Room","description":"Queen-size bed and cosy sitting area with walk-in shower. Large windows overlooking the courtyard or with city views. The perfect urban retreat.","images":[{"type":"Link","name":"Image","url":"https://gc.synxis.com//hotel/35787/Images/Room/standard_double.jpg"},{"type":"Link","name":"Image","url":"https://d321ocj5nbe62c.cloudfront.net/imageRepo/7/0/164/137/931/1._Standard_S.jpg"}],"rates":[{"name":"Advance Purchase","description":"Room only rate, inclusive of VAT.","baseRate":{"value":54100,"currencyCode":"gbp"},"priceId":"92653aeb66b5c7b7","taxes":[],"breakfastIncluded":false,"allInclusive":false,"refundable":{"available":false},"rule":"default","fees":[]},{"name":"Flexible Rate","description":"Room only rate, inclusive of VAT and excluding 5% rooms service charge.","baseRate":{"value":60000,"currencyCode":"gbp"},"priceId":"bcb202f07bb63175","taxes":[],"breakfastIncluded":false,"allInclusive":false,"refundable":{"available":false},"rule":"default","fees":[]}]}]}
<html><head><style>body{margin: 0;padding: 0;}</style></head><body><iframesrc='<3DS_CHALLENGE_URL>'width='100%'height='100%'frameborder='0'></iframe><script>
window.addEventListener('message',event=>{if(event.data ==='3dsecure-finished'){// We are done with 3D Secure!
console.log('3D Secure form closed.');}});</script></body></html>
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19
HTML content with iframe to render the 3D Secure challenge