Skip to main content
POST
Start checkout
Server-side checkout creation. Returns a Stripe-hosted URL; the caller redirects the user there. Never expose the Stripe secret key to the browser, this endpoint exists precisely to keep it server-side.

Body

string
required
Stripe price id. Must be one of the prices configured on the server (see GET /v1/stripe/catalog). Hostile price ids are rejected with 400 invalid_args.
string
Where to send the user after a successful payment. Default: ${origin}/PaymentSuccess?session_id={CHECKOUT_SESSION_ID}.
string
Where to send the user if they bail out. Default: ${origin}/PaymentCancel.

Response

kind is either "subscription" or "credit_pack", useful when the UI wants to show different post-checkout messaging.

Errors