Skip to main content
GET
Retrieve Confirmation Token

Autorizaciones

Authorization
string
header
requerido

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

Encabezados

Api-Version-Date
string

Pins the request to a dated API version.

Ejemplo:

"2026-11-17"

Parámetros de ruta

id
string
requerido

Confirmation token ID, prefixed ctok_.

Parámetros de consulta

account_id
string
requerido

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

Respuesta

confirmation token retrieved

billing_address
object | null
requerido

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
requerido

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

created_at
string
requerido

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

Ejemplo:

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

expires_at
string
requerido

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

Ejemplo:

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

id
string
requerido
Ejemplo:

"ctok_xxxxxxxxxxxxxx"

object
string
requerido

Always confirmation_token.

Ejemplo:

"confirmation_token"

payment_method_preview
object
requerido

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

setup_future_usage
string | null
requerido

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

Ejemplo:

"off_session"

status
enum<string>
requerido

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

Opciones disponibles:
pending,
consumed,
expired
Ejemplo:

"pending"