Skip to content
Stainless Stainless Stainless SDKs

Simulate

Simulate a card's tokenization
post/v1/simulate/tokenizations

This endpoint is used to simulate a card's tokenization in the Digital Wallet and merchant tokenization ecosystem.

Body Parameters
cvvstring

The three digit cvv for the card.

maxLength3
minLength3
expiration_datestring

The expiration date of the card in 'MM/YY' format.

maxLength5
minLength5
panstring

The sixteen digit card number.

maxLength16
minLength16
tokenization_sourceenum
Accepts one of the following: "APPLE_PAY", "GOOGLE", "SAMSUNG_PAY", "MERCHANT"

The source of the tokenization request.

Hide ParametersShow Parameters
"APPLE_PAY"
"GOOGLE"
"SAMSUNG_PAY"
"MERCHANT"
account_scorenumber
optional

The account score (1-5) that represents how the Digital Wallet's view on how reputable an end user's account is.

device_scorenumber
optional

The device score (1-5) that represents how the Digital Wallet's view on how reputable an end user's device is.

entitystring
optional

Optional field to specify the token requestor name for a merchant token simulation. Ignored when tokenization_source is not MERCHANT.

Returns
dataarray of tokenstringaccount_tokenstringcard_tokenstringcreated_atstringdpanstringstatusenumtoken_requestor_nameenumtoken_unique_referencestringtokenization_channelenumupdated_atstringdigital_card_art_tokenstringeventsarray of objectpayment_account_reference_idstringTokenization
optional
Request example Request
curl https://api.lithic.com/v1/simulate/tokenizations \
    -H 'Content-Type: application/json' \
    -H "Authorization: $LITHIC_API_KEY" \
    -d '{
      "cvv": "776",
      "expiration_date": "08/29",
      "pan": "4111111289144142",
      "tokenization_source": "APPLE_PAY"
    }'
200 Example
{
  "data": [
    {
      "token": "182bd5e5-6e1a-4fe4-a799-aa6d9a6ab26e",
      "account_token": "182bd5e5-6e1a-4fe4-a799-aa6d9a6ab26e",
      "card_token": "182bd5e5-6e1a-4fe4-a799-aa6d9a6ab26e",
      "created_at": "2019-12-27T18:11:19.117Z",
      "dpan": "dpan",
      "status": "ACTIVE",
      "token_requestor_name": "AMAZON_ONE",
      "token_unique_reference": "token_unique_reference",
      "tokenization_channel": "DIGITAL_WALLET",
      "updated_at": "2019-12-27T18:11:19.117Z",
      "digital_card_art_token": "182bd5e5-6e1a-4fe4-a799-aa6d9a6ab26e",
      "events": [
        {
          "token": "182bd5e5-6e1a-4fe4-a799-aa6d9a6ab26e",
          "created_at": "2019-12-27T18:11:19.117Z",
          "result": "APPROVED",
          "type": "TOKENIZATION_2FA"
        }
      ],
      "payment_account_reference_id": "payment_account_reference_id"
    }
  ]
}