Bookings

1. Create an experience checkout session (PREBOOK)

Overview

Create a temporary hold on the selected tour slot and a Stripe PaymentIntent for checkout.

When to Use

Checkout start — After the user picks option, slot, and participants from booking-options
Payment setup — Obtain transactionId and secretKey for Stripe SDK confirmation
Hold window — Reserve inventory for ~10 minutes before book

What You Get

Checkout context — tourId, optionId, dateTime, language, participants, and pricing echoed back
Provider refs — cartId, experienceBookingId, providerBookingId, status, reservationExpiresAt
Stripe fields — transactionId, secretKey, paymentTypes: ["TRANSACTION_ID"]

Quick Start

POST the same selection used for display pricing from booking-options with usePaymentSdk: true. Confirm payment with Stripe, then call POST /experiences/bookings.

Error codes

Product-operation codes are listed below. Shared authentication/access/rate-limit middleware can return common codes such as 401, 40301 or 4290. HTTP status and error code are separate; do not parse message text.

Code	Meaning
72001	selection price mismatch
72002	invalid experience selection
72003	prebook resource not found
72004	experience selection rejected by provider
72005	experience prebook conflicts with the current state
72006	prebook provider request failed
72007	prebook provider request timed out
72008	prebook request is unauthorized
72009	prebook request is forbidden
72010	prebook service is temporarily unavailable
72011	booking currency is not accepted for this selection
72099	failed to create prebook

For 72001, requested/expected are customer SELL totals; do not apply markup or FX again. Inspect the code on HTTP 400, 409 and 422. A generic no-money error must not open price-change consent.

post/experiences/tours/{id}/prebooks

Request

Base URL
https://api.liteapi.travel/v3.0
URL
https://api.liteapi.travel/v3.0/experiences/tours/{id}/prebooks
Auth
API key in header X-API-Key

Path parameters

idstring required

Tour identifier

Request body

languagestring required

ISO language code used for validate and downstream book cart.

currencystring required

ISO 4217 currency code used for validate and downstream book cart.

clientReferenceIdstring

Partner reference echoed in prebook response and stored on the checkout session.

usePaymentSdkboolean required

Phase 1 requires true to create a Stripe PaymentIntent.

voucherCodestring

Optional discount voucher code. When valid the voucher amount is deducted from the Stripe PaymentIntent and charged separately to the agency's stored card at book time.

Example request

{
  "selection": {
    "optionId": 1416025,
    "dateTime": "2026-07-18T07:00:00",
    "price": {
      "amount": 45.5,
      "currency": "EUR"
    },
    "participants": [
      {
        "ticketCategory": "adult",
        "numberOfParticipants": 2
      }
    ]
  },
  "language": "en",
  "currency": "EUR",
  "clientReferenceId": "partner-ref-1",
  "usePaymentSdk": true,
  "voucherCode": "SUMMER25"
}

Response

Prebook created with selection context, validate refs, and Stripe checkout fields

Example response

{
  "data": {
    "prebookId": "tJHcT_KHA",
    "tourId": 903304,
    "optionId": 1416025,
    "dateTime": "2026-07-18T07:00:00",
    "language": "en",
    "clientReferenceId": "partner-ref-1",
    "participants": [
      {
        "ticketCategory": "adult",
        "numberOfParticipants": 2
      }
    ],
    "price": 45.5,
    "commission": 3.64,
    "clientCommission": 3.64,
    "currency": "EUR",
    "cartId": "S82SPCWONTFLXI77Z4D66BZKI8S6ROZC",
    "experienceBookingId": "444fe833-a84e-49b4-ae9f-b032c8619419",
    "providerBookingId": "GC0915TB2VJT9CVM643S9OLYBEDDYBOL",
    "status": "temp",
    "transactionId": "tr_cts_test",
    "secretKey": "pi_secret_test",
    "voucherCode": "SUMMER25",
    "voucherTotalAmount": 10,
    "sellingPriceToUser": 35.5,
    "reservationExpiresAt": "2026-07-13T08:30:00Z",
    "paymentTypes": [
      "TRANSACTION_ID"
    ]
  }
}

Changes

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