Token Request Message (Tran Type 37)
Simplify supports a Token Request message from the POS process for cards processed as non-EMV or contact EMV. Not currently supported for contactless EMV.
The Token Request message is a non-financial message, used to obtain the Fusebox-assigned token for an account number.
For more information, see the Fusebox Integration Guide under Tokenization API Fields.
Sample Message
Request
An example of a Token Request message (from the POS to Simplify) is:
API Field #, Value | Description |
---|---|
0001,37 | Transaction Type. |
0002,0.00 | Transaction Amount. The amount should be 0.00 for a Token Request |
0007,1045 | Transaction ID / Reference Number |
0011,xxx.. | User Data. See Simplify-Controlled Field Definitions. |
0013,022519 | Transaction Date (current date) – MMDDYY |
0014,105007 | Transaction Time (current time) – HHMMSS |
0109,TERM1 | Terminal ID (provided by Elavon) |
0110,205 | Cashier ID |
0115,010 | Transaction Qualifier (010 = credit; 030 = debit) |
1008,ID: | Set to the value ‘ID:’ to request that an account Token be returned by Fusebox |
8002,RETL01 | Location Name (provided by Elavon) |
8006,TSTLAR | Chain Code (provided by Elavon) |
Response
An example of a Token Request Response message (from Simplify to the POS) is:
API Field #, Value | Description |
---|---|
0001,37 | Transaction Type |
0002,0.00 | Transaction Amount |
0003,ID:1111748353147271 | Account Token (returned by Fusebox) |
0004,1208 | Expiration Date – MMYY |
0007,1045 | Transaction ID / Reference Number |
0011,xxx.. | User Data. See Simplify-Controlled Field Definitions. |
0013,022519 | Transaction Date (current date) – MMDDYY |
0014,105007 | Transaction Time (current time) – HHMMSS |
0052,5 | Transponder / Proximity Indicator (0 = contact; 2 = contactless, 5 = swiped) |
0109,TERM1 | Terminal ID (provided by Elavon) |
0110,205 | Cashier ID |
0115,010 | Transaction Qualifier (010 = credit; 030 = debit) |
0126,2 | Track Indicator |
1000,VI | Card Type |
1001,VISA | Card Name |
1003,0000 | Gateway Response Code |
1004,ACKNOWLEDGED | Host Response Message |
1008,400555******4460 | Masked Account Number |
1010,COMPLETE | Gateway Response Message |
5001,30101151010800;16 | first 8 digits of PAN and PAN length, if enabled. (301 = Tag, 011 = Length of data, 51010800 = First 8 digits of PAN, ; = Delimiter, 16 = PAN length) |
5002,80378002 | Device Serial Number |
7007,11111799604661403 | Transaction Link Identifier. A unique identifier to link transactions |
8002,RETL01 | Location Name (provided by Elavon) |
8006,TSTLAR | Chain Code (provided by Elavon) |