Confirm a setup intent
Saves the card using a single-use payment token. The intent must be
in requires_confirmation. On success it moves to succeeded and
payment_method is set to the id of the created reusable payment
method. If vaulting fails the intent returns to requires_confirmation
so the client can retry with a fresh token.
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.
255Path Parameters
The setup intent id (seti_…).
Body
A single-use payment token created by the client-side card form.
Response
The confirmed 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.

