Menu

eProtect tokens

eProtect token examples are shown below. Each example includes a request and a response.

Headers

Include theTMS-specific headersin all of your requests.

Tokenize card

Tokenize card request and response examples are shown below.

  • cardDetails.cardNumber is required

Request

Copied!
{
    "token": {
        "payloadType": "card"
    },
    "cardDetails": {
        "cardNumber": "4111111111111111",
        "expirationDate": "02/22",
        "cvv2": "123"
    },
    "outputTokenProviderProfileIds": [
        "Your_eProtect_Profile"
    ]
}

Response

Copied!
{
    "tokens": [
        {
            "statusCode": "100",
            "tokenProvider": "eProtect Token Provider",
            "profileId": "Your_eProtect_Profile",
            "value": "4722926691316645442",
            "payloadType": "card",
            "tokenProviderRefId": "1a3a85aa19cd4ab59bb1a6468bcbadac",
            "isNewlyCreated": false
        }
    ],
    "statusCode": "100",
    "requestId": "JABnvFAg8kija73NmChfg"
}

Detokenize card

Detokenize card request and response examples are shown below.

  • Use includeCvv2 and/or includeExpirationDate if you want Cvv2 and/or expirationDate returned.
  • These values are only valid if the original tokenize request is included for these values.

Request

GET https://cert-tesapi.paymetric.com/api/tokens/4722926691316645442?profileId=Your_eProtect_Profile&payloadType=Card&includeCvv2=true&includeExpirationDate=true

Response

Copied!
{
    "cardDetails": {
        "cardNumber": "4111111111111111",
        "expirationDate": "02/22",
        "cvV2": "123"
    },
    "statusCode": "100",
    "requestId": "Pu6lPpjZ0uUbDVdgPFTw"
}