Tokenize With CVV

This endpoint allows you to simultaneously tokenize a data element and associate a CVV with its generated token.

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.
CVVstringThe CVV to be associated with the generated Token.
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": "545454587415454",
    "TokenHMAC": "QiuCu0FZuu0SUn2gMtRYQSHjkd30LgSf4QMM3yH1Dp0=",
    "FirstEight": "54545454"
}