Creates a checkout session with a 6-hour TTL. Returns a checkout_url that you can redirect customers to, or use the session ID to build a custom checkout experience. Supports both catalog products (by product_id) and dynamic line items (by name + amount).
Store ID (shp_ prefix)
Line items — use product_id for catalog products or name + amount for dynamic items
1 - 10 elementsReference an existing product from your catalog
Expected total in cents. If provided, must match the computed item total (validation safeguard).
100 <= x <= 1000000Coupon code to apply
64Tax ID (VAT number)
32Checkout UI configuration
Key-value pairs attached to the session. Flows through to the order and webhook payloads. Max 20 keys, key max 40 chars, value max 500 chars.
URL to redirect after successful payment. Must use HTTPS.
URL to redirect if the customer cancels. Must use HTTPS.