Skip to main content
GET
Retrieve Confirmation Token

Yetkilendirmeler

Authorization
string
header
gerekli

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

Başlıklar

Api-Version-Date
string

Pins the request to a dated API version.

Örnek:

"2026-11-17"

Yol Parametreleri

id
string
gerekli

Confirmation token ID, prefixed ctok_.

Sorgu Parametreleri

account_id
string
gerekli

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

Yanıt

confirmation token retrieved

billing_address
object | null
gerekli

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
gerekli

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

created_at
string
gerekli

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

Örnek:

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

expires_at
string
gerekli

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

Örnek:

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

id
string
gerekli
Örnek:

"ctok_xxxxxxxxxxxxxx"

object
string
gerekli

Always confirmation_token.

Örnek:

"confirmation_token"

payment_method_preview
object
gerekli

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

setup_future_usage
string | null
gerekli

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

Örnek:

"off_session"

status
enum<string>
gerekli

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

Mevcut seçenekler:
pending,
consumed,
expired
Örnek:

"pending"