Create a setup intent
Creates a setup intent in requires_confirmation status. Supply a
currency and, for customer-attached mandates, a customer id. Once
created, collect a single-use payment token from the client and call
confirm.
Authorizations
A merchant secret key (sk_…) sent as Authorization: Bearer <key>.
Headers
A unique key that makes retries safe: the same key with the same request body returns the original response instead of repeating the operation.
255Body
Response
The created setup intent.
Unique identifier for the setup intent (seti_…).
setup_intent The customer this intent is attached to (cus_…), or null if not customer-scoped.
Three-letter ISO currency code.
requires_confirmation — initial state; awaiting a client-side token.
processing — vault operation is in progress.
succeeded — card vaulted and payment method created.
canceled — intent was canceled before completion.
requires_confirmation, processing, succeeded, canceled The reusable payment method created when the card was vaulted (pm_…). Null until succeeded.
Unix epoch seconds.
Unix epoch seconds.

