v12

latestOpenAPI 3.0.3raw.githubusercontent.com2026-08-011518127.5 KB

Direct Integration

Tokenize Card Data

Securely tokenize card data using Tonder's vault service. This endpoint converts sensitive card information into individual field tokens that can be safely stored and used for payments.

Authentication: Requires access token from /tokenization/auth/ endpoint.

post/token

Request body

card_numberstring required

The full card number (13-19 digits)

cardholder_namestring required

The name as it appears on the card

cvvstring required

Card security code (3-4 digits)

expiration_monthstring required

Card expiration month (MM format)

expiration_yearstring required

Card expiration year (YYYY format)

Example request

{
  "card_number": "4242424242424242",
  "cardholder_name": "John Doe",
  "cvv": "123",
  "expiration_month": "07",
  "expiration_year": "2025"
}

Response

Card data tokenized successfully

card_numberstring

Token representing the card number

cardholder_namestring

Token representing the cardholder name

cvvstring

Token representing the CVV

expiration_monthstring

Token representing the expiration month

expiration_yearstring

Token representing the expiration year

Example response

{
  "card_number": "9230-0892-4469-1474",
  "cardholder_name": "c05d89b2-299c-4f93-b49a-42be00d3b64b",
  "cvv": "d31f0da3-0ed3-4ad8-8b68-14c2669a99a7",
  "expiration_month": "e401a32e-4174-424f-9688-727005f6a80e",
  "expiration_year": "bd9ccc23-3d00-4109-9626-fc6581389063"
}