Checkout Session
Pronunciation: CHEK-owt SESH-un
Definition
A checkout session is a server-side or platform object that stores the temporary state and configuration needed to guide a customer through checkout. It can contain cart, customer, currency, payment methods, addresses, discounts, taxes, return URLs, expiration, and links to payment attempts and orders. The session is not the final order or settled payment and can expire, be.
Overview
Understand the idea
A checkout session is a server-side or platform object that stores the temporary state and configuration needed to guide a customer through checkout.
It can contain cart, customer, currency, payment methods, addresses, discounts, taxes, return URLs, expiration, and links to payment attempts and orders. The operational lifecycle of Checkout Session can involve customer input, authorization, pricing, payment instructions, transaction submission, detection, confirmation, settlement, reconciliation, and exception handling. Each Checkout Session stage should have a distinct state and timestamp so that an incomplete step is not mistaken for final payment.
What actually happens
A checkout session is a temporary, identifiable attempt to collect payment for a particular purchase. It connects a customer-facing page with server-side order data, an allowed payment method, a quoted amount and rules for success or expiry. In crypto, one checkout session may involve a wallet connection, invoice address, token selection and several network observations before the order can be fulfilled.
The merchant creates a session from its trusted backend with an order reference and authoritative price. The session exposes only approved networks and assets and generates the relevant wallet destination and payment instructions. Monitoring links incoming transfers and callbacks to that session, then moves it through pending, paid, expired or exception states under server-side rules. Session identifiers should not grant unrelated access, and refreshes must not accidentally create duplicate financial obligations.
Decisions and failure cases
Client redirects and 'success' URLs are user-interface signals, not financial proof. A customer can close the page after sending funds, so backend monitoring must continue independently. Multiple sessions for one order require explicit rules for duplicate deposits, late money and inventory reservation.
Related concepts
Checkout, Checkout Conversion, Checkout Payment.
Further reading
Example
A buyer chooses a $120 product and opens a crypto checkout page. At first it shows a USDC quote on a selected network. The buyer closes the tab, returns after the rate quote expired and requests a refreshed attempt. The underlying order persists, but the obsolete session details should not silently become the new authorized payment instruction.
Comparison
An order expresses what the merchant sold. A checkout session records one effort to collect it. An invoice or payment link may create and reuse sessions, but they are not necessarily identical records.
Key Takeaway
A checkout session is a server-side or platform object that stores the temporary state and configuration needed to guide a customer through checkout.
Sources
- Build a Payments Page — Stripe (2026-08-02)
- Checkout Sessions API Reference — Stripe (2026-08-02)