Create a checkout configuration
Creates a reusable checkout configuration for an existing or inline plan.
Authorizations
An account API key, account scoped JWT, app API key, or user OAuth token.
Headers
Pins the request to a dated API version.
"2026-07-08-1"
Body
Account ID, prefixed biz_.
Existing plan ID, prefixed plan_. Mutually exclusive with plan.
Plan attributes used to create or find a plan for this checkout configuration. Mutually exclusive with plan_id.
Checkout mode: payment collects payment for a plan now; setup saves payment details without charging. Defaults to payment.
payment, setup Currency used for setup-mode payment method availability.
Affiliate code to apply to the checkout.
Custom key-value metadata copied to payments and memberships.
URL customers are sent to after checkout.
3D Secure behavior for this checkout.
Payment method overrides for this checkout. null uses the plan or platform defaults.
Response
checkout configuration created
Checkout configuration ID, prefixed ch_.
When the checkout configuration was created, as an ISO 8601 timestamp.
When the checkout configuration was last updated, as an ISO 8601 timestamp.
Account ID, prefixed biz_.
Checkout mode: payment collects payment now; setup saves payment details for later.
payment, setup Currency used for setup-mode payment method availability; defaults to usd when omitted.
Plan used for payment checkout. null in setup mode.
Affiliate code applied at checkout, or null when none is set.
Custom key-value metadata copied to payments and memberships. null without the checkout_configuration:basic:read scope.
URL customers are sent to after checkout, or null when no redirect is configured.
Checkout URL you can send to customers.
3D Secure behavior for this checkout, or null to use the account default.
Payment method overrides for this checkout. null when it uses the plan or platform defaults.

