Tokenize

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

Endpoints

Environment	URL
Test	https://test-htp.tokenex.com/api/sdk/Tokenize

API Parameters

Parameter	Data Type	Description
TokenExID	string	The merchant's TokenEx ID.
Timestamp	string	The timestamp (UTC) when the hash is generated, in yyyyMMddHHmmss format.
AuthenticationKey	string	The Authentication Key generated on the merchant's server.
Data	string	The data to be tokenized.
TokenScheme	enum	The Token Scheme to be used to tokenize the provided data. See Universal Token Schemes.
UseExtendedBIN	bool	Optional 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

Response

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

UseExtendedBIN:true

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