Skip to main content
GET
Retrieve setup intent
This page documents the Legacy API. For new integrations, use Retrieve Setup Intent in the Current API.
Required permissions:
  • payment:setup_intent:read
  • member:basic:read
  • member:email:read

인증

Authorization
string
header
필수

An Account API key, account-scoped JWT, App API key, or user OAuth token. Prepend the key or token with Bearer, for example Bearer ***************************.

Scopes

payment:setup_intent:read
member:basic:read
member:email:read

경로 매개변수

id
string
필수

The unique identifier of the setup intent.

예시:

"sint_xxxxxxxxxxxxx"

응답

A successful response

A setup intent allows a user to save a payment method for future use without making an immediate purchase.

checkout_configuration
object | null
필수

The checkout session configuration associated with this setup intent. Null if no checkout session was used.

company
object | null
필수

The company that initiated this setup intent. Null if the company has been deleted.

created_at
string<date-time>
필수

The datetime the setup intent was created.

예시:

"2023-12-01T05:00:00.401Z"

error_message
string | null
필수

A human-readable error message explaining why the setup intent failed. Null if no error occurred.

예시:

"Your card was declined."

id
string
필수

The unique identifier for the setup intent.

예시:

"sint_xxxxxxxxxxxxx"

member
object | null
필수

The company member associated with this setup intent. Null if the user is not a member.

metadata
object | null
필수

Custom key-value pairs attached to this setup intent. Null if no metadata was provided.

payment_method
object | null
필수

The saved payment method created by this setup intent. Null if the setup has not completed successfully.

status
enum<string>
필수

The current status of the setup intent.

사용 가능한 옵션:
processing,
succeeded,
canceled,
requires_action
three_ds_verified
boolean
필수

Whether 3D Secure authentication was completed when this payment method was set up.