Skip to main content
GET
Retrieve Confirmation Token

인증

Authorization
string
header
필수

An Account API key, an App API key, an account access token, an account-scoped user token, or a user OAuth token. Prepend the key or token with Bearer, for example Bearer ***************************. See Auth & API keys for how to get each one.

Scopes

payment:basic:read

헤더

Api-Version-Date
string

Pins the request to a dated API version.

예시:

"2026-11-17"

경로 매개변수

id
string
필수

Confirmation token ID, prefixed ctok_.

쿼리 매개변수

account_id
string
필수

The account the token was minted for, prefixed biz_. It must match the token's account.

응답

confirmation token retrieved

billing_address
object | null
필수

The collected billing address, including the name on the address. Null when not collected or without bearer authentication with payment:basic:read on the token’s account.

billing_details
object | null
필수

Billing preview supplied at collection: email, name, country and postal code.

created_at
string
필수

When the token was created, as an ISO 8601 timestamp.

예시:

"2026-01-01T12:00:00.000Z"

expires_at
string
필수

When the token expires, as an ISO 8601 timestamp. Tokens are single-use and short-lived.

예시:

"2026-01-01T12:00:00.000Z"

id
string
필수
예시:

"ctok_xxxxxxxxxxxxxx"

object
string
필수

Always confirmation_token.

예시:

"confirmation_token"

payment_method_preview
object
필수

Display-only preview of the collected method — never the underlying token.

setup_future_usage
string | null
필수

Save-consent state the element displayed at collection: off_session, on_session, or null. Confirm may vault only if attested here.

예시:

"off_session"

status
enum<string>
필수

pending until it is used, then consumed; expired once its short lifetime elapses. Only a pending token can be charged.

사용 가능한 옵션:
pending,
consumed,
expired
예시:

"pending"