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

