The Setup Intent object

The SetupIntent object represents an attempt by your customer to set up a payment method for future charges without making a payment. A CheckoutSession created with the setup or subscription flow includes the setup intent in setup_intent. You can retrieve the setup intent with the Get setup intent endpoint. The status field tracks the setup through created, started, waiting_for_retry, succeeded, and failed.

Setup Intent Object

{
  "id": "seti_2cKoy3PEXAuvkr4ofXC1KdMvCgZ",
  "object": "setup_intent",
  "error_reason": "invalid_card",
  "status": "failed"
}

Attribute	Type	Description
`id`	`string`	Unique identifier for the `SetupIntent` object.
`object`	`string`	Type of the object. Always `setup_intent`.
`error_reason`	`string` or `null`	Error code explaining why the latest setup attempt failed. `null` while no attempt has failed, or after the setup succeeds. See Setup intent error reasons for the full list.
`status`	`string`	Setup status. One of `created`, `started`, `waiting_for_retry`, `succeeded`, or `failed`. The setup starts as `created`, moves to `started` while in progress, moves to `waiting_for_retry` after a retryable failure, and ends as `succeeded` or `failed`.

Fintoc API

Main Resources

Payments API

Transfers API

Movements API

Direct Debit (Legacy)

Fiscal API

The Setup Intent object