Token Request Message (Tran Type 37)
Simplify supports a Token Request message from the POS process.
The Token Request message is a non-financial message, used to obtain the Fusebox assigned token for an account number.
Token Request Message
An example of a Token Request message (from the POS process to the Simplify application) is:
| API Field #, Value | Description |
|---|---|
| 0001,37 | Transaction Type. A value of 37 indicates a Token Request |
| 0002,0.00 | Transaction Amount. The amount should be 0.00 for a Token Request |
| 0007,1045 | Transaction ID / Reference Number. (Must increment on every new request) |
| 0109,TERM1 | Terminal ID provided by Elavon |
| 0110,205 | Cashier ID |
| 0115,010 | Transaction Qualifier (010 = Credit tender) |
| 1008,ID: | Field 1008 is 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 |
Note: For the message from Simplify to Fusebox, Simplify will populate the Account Data fields (and PIN and KSN fields for Debit transactions).
Token Request Response
An example of a Token Request Response message (from the Simplify application to the POS process) 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 |
| 0052,3 | Transponder / Proximity Indicator (3 = contactless, 5 = swiped) |
| 0109,TERM1 | Terminal ID provided by Elavon |
| 0110,205 | Cashier ID |
| 0115,010 | Transaction Qualifier (010 = Credit Tender) |
| 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 |
| 5002,169018710 | 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 |
Note: If account data is entered manually and CVV2/AVS prompting is enabled for the tender type used in the transaction (typically for credit only), the online response includes two additional fields:
| API Field #, Value | Description |
|---|---|
| 0050,**** | CVV2 4 bytes (masked) |
| 0700,94588 | AVS 5-9 bytes (true zip code) |