Sign in
Billing payment method setup

Create a billing payment method setup

Create a hosted checkout session for adding or replacing an organization's payment method

Authorization

A service token or OAuth token must have at least one of the following access or scopes in order to use this API endpoint:

Service Token Accesses write_payment_method

OAuth Scopes

ResourceScopes
Organizationwrite_payment_method
post/organizations/{organization}/billing/payment-method-setups

Path parameters

organizationstring required

Organization name slug from list_organizations. Example: acme.

Response

Returns the billing payment method setup

type'BillingPaymentMethodSetup' required

The resource type

idstring required

The billing payment method setup ID

state'pending' | 'completed' | 'failed' | 'expired' required

The setup state

checkout_urlstring nullable required

The hosted checkout URL while the setup is pending

errorstring nullable required

The failure message when the setup failed

expires_atstring nullable required

When the pending setup expires

completed_atstring nullable required

When the setup completed

failed_atstring nullable required

When the setup failed

Changes