POST
Create a setup intent for a reusable payment method

Authorizations

x-api-key
string
header
required

Server-side merchant API key. Never expose it in browser code.

Headers

Idempotency-Key
string

Retry-safe key for create operations.

Body

application/json
customerId
string
required
paymentMethodTypes
string[]
usage
enum<string>
default:on_session
Available options:
on_session,
off_session

Response

Setup intent created

id
string
required
status
enum<string>
required
Available options:
requires_action,
processing,
succeeded,
cancelled
customerId
string
required
paymentMethodId
string