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) |