Store a card

Tokenize a Credit Card

post

Creates a secure token for a credit card along with payer data. Optionally performs a micro-deposit validation to verify the card's validity.

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

Body

application/json

micro_deposit_enabledbooleanOptional

When true (default), performs a micro-deposit to validate the card

Default: trueExample: true

Responses

200

Successful operation

application/json

holder_namestringOptional

Cardholder name

Example: Luis Perez

expiration_monthintegerOptional

Expiration month

Example: 10

expiration_yearintegerOptional

Expiration year

Example: 2028

last_four_digitsstringOptional

Last four digits of the card

Example: 1111

card_identifierstringOptional

Unique card identifier (token) for future transactions

Example: CID-2210908e-6d8e-468d-9eb3-d551e8b541a0

401

Unauthorized access

application/json

post

/v3/tokenization

HTTPcURLJavaScriptPython

POST /v3/tokenization HTTP/1.1
Host: cc-api-stg.onekeypayments.com
X-Date: 2026-03-03T04:01:30.327Z
X-Login: text
Authorization: text
Content-Type: application/json
Accept: */*
Content-Length: 267

{
  "credit_card": {
    "holder_name": "Luis Perez",
    "expiration_month": 10,
    "expiration_year": 2028,
    "number": "4111111111111111",
    "cvv": "123"
  },
  "payer": {
    "country": "BR",
    "first_name": "John",
    "last_name": "Perez",
    "document_type": "CPF",
    "document": "12345678"
  },
  "micro_deposit_enabled": true
}

{
  "holder_name": "Luis Perez",
  "expiration_month": 10,
  "expiration_year": 2028,
  "last_four_digits": "1111",
  "card_identifier": "CID-2210908e-6d8e-468d-9eb3-d551e8b541a0"
}