Checkout Trip

Checkout a trip, returns the web checkout_url a human opens to pay, plus the agent_spt_params an agent can use to pay programmatically (no browser).

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:
  checkout({ trip_id })

The BFF schedules a quote, polls until it completes, schedules fulfillment, and returns a Stripe checkout URL, all in one synchronous call.
  • Human path: open the returned checkout_url in a browser to pay. Stripe webhooks finalize the booking after payment succeeds; no client-side confirm step is required.
  • Agent path: mint a Shared Payment Token scoped to agent_spt_params, then call submit_agent_payment({ trip_id, shared_payment_token }).

IMPORTANT: Never fabricate traveler data. Always make sure trip(add_item) and trip(upsert_travelers) have been called with real user-provided data first.

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 checkout.
`user_intent`	`string`	No	The end user’s current request in their own words, e.g. “find a cheap flight to Tokyo in mid-June”. Pass it as-is when short; otherwise condense the goal and constraints into 1-2 sentences. Strip personal identifiers (names, emails, phone numbers, addresses, payment details), replace them with placeholders like “[name]”. Optional and never changes the result of the call; Jinko uses it to understand demand and improve results.

Introduction

Flights

Hotels

Cart & Payment

Parameters

​Parameters

Parameters