v1

latestOpenAPI 3.0.0UNLICENSED2026-07-26178479713.7 KB

Card Tokens

card_tokens_token_id_delete

scopes:

admin:checkout

delete/accounts/{aid}/payments/card-tokens/{token_id}

Path parameters

token_idstring required

The payment_token_id or recurrence_token_id for the token to delete.

Request body

reasonstring

Short description of the reason for the token deletion.

requestor'CARDHOLDER' | 'MERCHANT'

Entity initiating the token deletion.

Example request

{
  "reason": "Profile deleted",
  "requestor": "MERCHANT"
}

Response

Card Token

idstring required

tokenstring

type'payment_token' required

status'ACTIVE' | 'INACTIVE' | 'SUSPENDED' | 'CANCELLED' | 'DELETED' required

card_brand'visa' | 'mastercard' required

masked_panstring

pan_expiry_datestring \d{2}/\d{4}

token_expiry_datestring \d{2}/\d{4}

customer_idstring

account_idstring required

relationship_idstring

Reference to the merchant entity for which the token is dedicated. Merchant-dedicated tokens are uniquely created per merchant_relationship_id.

transaction_idstring checkout-id

Reference to the transaction where the token was created

external_token_referencesstring[]

External references to migrated card tokens

payment_product_typestring required

created_atstring date-time required

created_bystring

updated_atstring date-time required

deleted_atstring date-time

deleted_bystring

Example response

{
  "masked_pan": "476173******0416",
  "pan_expiry_date": "09/2030",
  "token_expiry_date": "09/2030",
  "account_id": "P12345678",
  "payment_product_type": "dintero_psp.creditcard"
}