Create a booking

Creates a booking from a valid quote. Quotes that require prebook must be locked before payment. Provide at least one valid adult lead guest per booked room. Do not send placeholder guests for children or unnamed occupants; the quote already stores the occupancy. Returns a Stripe-hosted checkout URL for payment by default. stripe_checkout is a hosted browser payment flow, not a headless server-to-server payment call: redirect the customer browser to the returned payment.url. After payment, Tell&Go confirms the booking server-side from the Stripe webhook and supplier status checks. API consumers can read final status with GET /bookings/{id} and may optionally register partner webhooks for async status events.

post/book

Request

  • Base URL: https://api.tellandgo.com/api/v1/agent
  • URL: https://api.tellandgo.com/api/v1/agent/book
  • Auth: API key in header X-API-Key

Headers

Idempotency-Keystring required

Required for financial operations. Reuse the same key for a retry of the same request. Keys are scoped to the integration and operation for 24 hours; reusing one with a different body returns HTTP 409.

Request body

quote_idstring required
special_requestsstring
payment_method'stripe_checkout' | 'redirect'

Payment method. stripe_checkout (default) returns a Stripe-hosted payment URL. redirect (deprecated) returns a URL to our checkout page.

success_urlstring uri

Optional HTTPS URL to return the payer to after Stripe-hosted checkout succeeds. Tell&Go appends booking_id and session_id when missing.

cancel_urlstring uri

Optional HTTPS URL to return the payer to if Stripe-hosted checkout is cancelled. Tell&Go appends booking_id and payment=cancelled when missing.

Response

Booking created

successboolean

Changes

No recorded changes to this operation across all 1 revision of this API.