Parameters
| Name | Type | Required | Description |
|---|---|---|---|
trip_id | string | Yes | Trip ID from the trip tool. The trip must have items (add_item) and travelers (upsert_travelers) set before booking. |
Pricing & booking
Book Trip
Schedule checkout for a trip — returns a Stripe checkout URL the user can open in a browser to complete payment
Schedule checkout for a trip — returns a Stripe checkout URL the user can open in a browser to complete payment.
PREREQUISITES (call these first via the trip tool):
trip(add_item) → add the chosen flight or hotel to the trip
trip(upsert_travelers) → set traveler details + contact info
trip(select_ancillaries) [optional] → add bags/seats/meals before quoting (flights only)
USAGE:
book({ trip_id })
The BFF schedules a quote, polls until it completes, schedules fulfillment, and returns a Stripe checkout URL — all in one synchronous call. Open the returned checkout_url in a browser to complete payment. Stripe webhooks finalize the booking after payment succeeds; no client-side confirm step is required.
IMPORTANT: Never fabricate traveler data. Always make sure trip(add_item) and trip(upsert_travelers) have been called with real user-provided data first.