Retrieve Card Token Endpoint

Retrieve Token Information

get

Fetches basic information about a previously tokenized credit card using its unique identifier.

Authorizations

apiKeyAuthauthHeader

Path parameters

card_identifierstringRequired

The unique card token obtained during tokenization

Header parameters

Content-TypestringRequired

Media type of the body sent to the API

Default: application/json

X-Datestring · date-timeRequired

ISO8601 Datetime with Timezone (yyyy-MM-dd'T'HH:mm:ssZ)

X-LoginstringRequired

Merchant X-Login API Key

AuthorizationstringRequired

Authorization control hash

X-Idempotency-KeystringOptional

Unique idempotency key for ensuring that the same request is not processed more than once

Responses

200

Successfully retrieved card information

application/json

400

Invalid request format

application/json

401

Unauthorized

application/json

404

Token not found

application/json

get

HTTPcURLJavaScriptPython

GET /v3/tokenization/{card_identifier} HTTP/1.1
Host: cc-api-stg.directa24.com
X-Login: text
Content-Type: application/json
X-Date: 2025-05-14T11:42:17.121Z
Authorization: text
Accept: */*

{
  "holder_name": "Luis Perez",
  "expiration_month": 10,
  "expiration_year": 2028,
  "last_four_digits": "1111"
}

Request

Path Parameters

Parameter	Type	Required	Description
card_identifier	String	Yes	The unique card token obtained during tokenization

Response

Success Response (200 OK)

{
  "holder_name": "Luis Perez",
  "expiration_month": 10,
  "expiration_year": 2028,
  "last_four_digits": "1111"
}

Response Fields

Field	Type	Description
holder_name	String	Cardholder name
expiration_month	Integer	Expiration month
expiration_year	Integer	Expiration year
last_four_digits	String	Last four digits of the card

Error Responses

HTTP Status	Error Code	Description
404	510	Token not found
401	511	Token expired
401	512	Unauthorized access

Error Response Example

{
    "code": 510,
    "description": "Token not found"
}

Integration Example

cURL Example

curl --request GET \
  --url https://cc-api-stg.directa24.com/v3/tokenization/YOUR_CARD_IDENTIFIER \
  --header 'Content-Type: application/json' \
  --header 'X-Date: 2024-05-12T14:30:00Z' \
  --header 'X-Login: YOUR_API_KEY' \
  --header 'Authorization: YOUR_AUTHORIZATION_HASH'

Common Use Cases

1. Display masked card details: Use the returned information to show card details to users in a PCI-compliant way

2. Pre-fill checkout forms: Use the card information to pre-populate checkout forms while keeping sensitive data secure

3. Verify expiration: Check if a card is approaching expiration to prompt the user for an update

Notes

• For security reasons, this endpoint only returns basic card information (cardholder name, expiration date, and last four digits)

• The complete card number and CVV are never returned

• The token must belong to your merchant account; otherwise, a 404 error will be returned

• This endpoint is useful for displaying saved payment methods to your users