Document ValidationsPayment Methods

Retrieve Card Token Endpoint

Retrieve Token Information

get

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

Authorizations
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
get
GET /v3/tokenization/{card_identifier} HTTP/1.1
Host: cc-api-stg.directa24.com
X-Login: text
Content-Type: application/json
X-Date: 2025-06-26T08:58:46.497Z
Authorization: text
Accept: */*

{
  "holder_name": "Luis Perez",
  "expiration_month": 10,
  "expiration_year": 2028,
  "last_four_digits": "1111",
  "brand": "VISA",
  "first_six": "411111"
}

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

PreviousCreate Card Token EndpointNextDelete Card Token Endpoint

Last updated

Was this helpful?