1. Create a checkout session (PREBOOK)

Overview

Step 1 of 2 in the booking flow. Create a prebook session to check the availability of a rate and get final pricing before payment. This prebookId needed to complete the booking.

When to Use

• Before payment - Always call this before completing a booking
• Rate confirmation - Verify final pricing and availability
• Session creation - Generate a checkout session for your payment flow

What You Get

• Prebook ID - Required for the next step (completing the booking)
• Final pricing - Confirmed rates with all fees and taxes
• Terms and conditions - Cancellation policies and booking rules
• Room details - Complete information about the selected rooms

Key Features

• Live availability check - Verifies the rate is available before you collect payment
• Payment SDK support - Set usePaymentSdk=true to use client-side payment forms
• Reusable - PrebookId can be used for multiple bookings if needed

Quick Start

Provide the offerId from your hotel rates search and set usePaymentSdk (true/false). Returns a prebookId to use in the next step.

Next Step: Use the prebookId with /rates/book to complete the booking.