This endpoint serves to generate a token based on the provided Token Scheme and data to be tokenized.

Endpoints

API Parameters

ParameterData TypeDescription
TokenExIDstringThe merchant's TokenEx ID.
TimestampstringThe timestamp (UTC) when the hash is generated, in yyyyMMddHHmmss format.
AuthenticationKeystringThe Authentication Key generated on the merchant's server.
DatastringThe data to be tokenized.
TokenSchemeenumThe Token Scheme to be used to tokenize the provided data. See https://docs.tokenex.com/?page=appendix#token-schemes for TokenSchemes.
UseExtendedBINboolOptional parameter: Allows for 8 digit BIN to be returned in the tokenize response (Only available for PCI token scheme). Defaults to false.

Request

{
  "tokenexid": "YourTokenExID",
  "timestamp": "20180109161437",
  "authenticationKey": "3mHJFag1ICQiwRdSw1QY86WUvt3IDklswf6AA/q+wdU=",
  "data": "5454545454545454",
  "tokenScheme": "sixTOKENfour",
  "cvv": "123",
  "useExtendedBin": false
}

Response

{
    "Error": null,
    "Success": true,
    "ReferenceNumber": "18010916143712345678",
    "Token": "545454587415454",
    "TokenHMAC": "QiuCu0FZuu0SUn2gMtRYQSHjkd30LgSf4QMM3yH1Dp0="    
}
{
    "Error": null,
    "Success": true,
    "ReferenceNumber": "18010916143712345678",
    "Token": "5454545454545454",
    "TokenHMAC": "QiuCu0FZuu0SUn2gMtRYQSHjkd30LgSf4QMM3yH1Dp0="
    "FirstEight": "54545454"
}