Create Checkout Session

Amount in minor units, denominated in currency (the initiation currency).

Currency of the session (ISO 4217). Without a rateLockId this is the collection currency the payer pays in. With a rateLockId it must equal the lock’s base currency (the currency you price in, e.g. USD); the payer is then charged the equivalent in the lock’s quote currency at the lock’s all-in rate.

Optional. The collection currency — the currency the payer is actually charged in. Defaults to the primary currency for payerDetails.location when omitted. When collectionCurrency differs from currency, Adaptive Currency Conversion applies: priced by the supplied rateLockId, or by its default per-session quote minted at session creation.

Optional rate lock to apply to this session. When set, the session currency must equal the lock’s base currency, the session’s collection currency must equal the lock’s quote currency, and the payer is charged the equivalent in the lock’s quote currency at the lock’s all-in rate. The lock is verified at session creation and again when a payment is initiated; a lock that is unknown, expired, or cancelled is rejected with 422. If omitted and collectionCurrency differs from currency, the conversion falls back to Adaptive Currency Conversion’s default per-session rate.

Optional session lifetime in seconds (30 seconds to 7 days). The payment confirmation window expires this long after creation; defaults to the standard session lifetime when omitted.