Skip to main content
The order flow follows a session-based checkout pattern:
  1. Create a checkout session — locks the product version, pricing, and currency
  2. Create an order — initiates payment and returns a PSP-hosted checkout URL
  3. Cancel an order — cancels a pending (unpaid) order before payment completes
Create-order requires more than the obvious fields. Alongside checkoutSessionId and billingDetail, both /v1/actions/onetime-order/create-order and /v1/actions/subscription-order/create-order require language and userTerminal (e.g. "en" / "desktop") — omitting either returns 400 Invalid input with no hint about which field is missing. Authenticate with the session token alone: adding X-Store-Slug next to the Authorization header fails with Multiple authentication methods detected.

One-Time Order Status Values

Endpoints

Create Checkout Session

Lock product version and pricing for checkout

Cancel One-Time Order

Cancel a pending order before payment