Skip to main content

Tokenization Endpoint

Securely tokenizes payment card data (credit/debit cards) by converting sensitive card details into a unique, non-sensitive token. The token can be safely stored and used for future transactions without retaining raw card data, reducing PCI DSS compliance scope while enabling repeat purchases.

CREATE Token​

If you want to create a payment token, please use a request similar to this one:

curl -i -X POST \
  'https://tokenization.payments.ai/tokens' \
  -H 'Content-Type: application/json' \
  -H 'Authorization: ApiKey <keyValue>' \
  -H 'X-Organization-Id: <orgId>' \
  -d '{
    "method": "payment-card",
    "paymentInstrument": {
      "pan": "4111111111111111",
      "expMonth": 12,
      "expYear": 2030,
      "cvv": "123"
    },
    "billingAddress": {
      "firstName": "Joe",
      "lastName": "Doe",
      "address": "123 Main St",
      "city": "Springfield",
      "region": "NY",
      "postalCode": "10009",
      "country": "US"
    }
  }' -v

The response will be a JSON object with the following structure:

{
  "id": "123456789abcdefghij0",
  "createdTime": "2025-12-18T08:30:16+00:00",
  "expirationTime": null
}

READ Tokens​

To get a list of payment tokens, please use a request similar to this one:

curl -X 'GET' \
 'https://tokenization.payments.ai/tokens' \
 -H 'accept: application/json' \
 -H 'Authorization: ApiKey <keyValue>' \
 -H 'X-Organization-Id: <orgId>'

The response will be a JSON object with the following structure:

[
  {
    "id": "123456789abcdefghij0",
    "createdTime": "2025-12-16T08:30:16+00:00",
    "expirationTime": null
  },
  {
    "id": "123456789abcdefghij1",
    "createdTime": "2025-12-17T08:30:16+00:00",
    "expirationTime": null
  },
  {
    "id": "123456789abcdefghij2",
    "createdTime": "2025-12-18T08:30:16+00:00",
    "expirationTime": "2026-12-18T08:30:16+00:00"
  }
]

READ Token by Id​

To get a particular payment token, please use a request similar to this one:

curl -X 'GET' \
 'https://tokenization.payments.ai/tokens/:id' \
 -H 'accept: application/json' \
 -H 'Authorization: ApiKey <keyValue>' \
 -H 'X-Organization-Id: <orgId>'

The response will be a JSON object with the following structure:

{
  "id": "123456789abcdefghij0",
  "createdTime": "2025-12-18T08:30:16+00:00",
  "expirationTime": null
}