Skip to main content
GET
Retrieve Confirmation Token

Autorisationer

Authorization
string
header
påkrævet

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

Overskrifter

Api-Version-Date
string

Pins the request to a dated API version.

Eksempel:

"2026-11-17"

Sti-parametre

id
string
påkrævet

Confirmation token ID, prefixed ctok_.

Forespørgselsparametre

account_id
string
påkrævet

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

Svar

confirmation token retrieved

billing_address
object | null
påkrævet

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
påkrævet

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

created_at
string
påkrævet

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

Eksempel:

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

expires_at
string
påkrævet

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

Eksempel:

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

id
string
påkrævet
Eksempel:

"ctok_xxxxxxxxxxxxxx"

object
string
påkrævet

Always confirmation_token.

Eksempel:

"confirmation_token"

payment_method_preview
object
påkrævet

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

setup_future_usage
string | null
påkrævet

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

Eksempel:

"off_session"

status
enum<string>
påkrævet

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

Tilgængelige muligheder:
pending,
consumed,
expired
Eksempel:

"pending"