Create a Checkout Session
POST/checkout/sessions
Creates a hosted checkout session. You may reference items by catalog_price_id (preferred) or by provider price_id.
Request
Responses
- 201
- 400
- 401
- 403
- 409
- 422
- 429
- 500
Created
Response Headers
Location
Checkout URL for redirection
Bad Request
Unauthorized
Forbidden (realm/account mismatch, billing_account_id not derived from session/principal, or insufficient role)
Conflict (idempotency body mismatch or duplicate adjustment)
Unprocessable Entity (validation, visibility, or binding/meter unresolved)
Rate limited
Response Headers
Retry-After
Seconds to wait before retry.
Internal Server Error