Booking Wizard

Overview of the booking wizard endpoints for multi-step checkout flows.

Endpoints

Method	Path	Description
POST	/v1/bookings/wizard/session	Create or update a wizard session and persist progress between steps.
GET	/v1/bookings/wizard/:id	Retrieve the saved wizard session payload.
POST	/v1/bookings/wizard/:id/commit	Validate the session and create a booking.
POST	/v1/bookings/wizard	Submit a snapshot for asynchronous booking orchestration.

Wizard endpoints require workspace-scoped API keys. Read routes need bookings:read; mutations require bookings:write.

Key concepts

• Wizard session: JSON payload stored in bookings.wizard_sessions, tracking steps (step_1…step_4), passengers, rooms, add-ons, and billing.
• Partial saves: POST /wizard/session merges payloads when id is provided, allowing clients to save after each step.
• Commit: POST /wizard/:id/commit enforces workspace-configured billing/passenger forms and creates a draft booking, returning bookingId.
• Async submission: POST /wizard accepts a validated snapshot (without writing to the DB) and queues downstream workflows.
• Workspace resolution: Sessions automatically infer workspace from product/departure if not supplied in the request context.