Sale Message (Tran Type 02)
Simplify supports a Sale message from the POS process.
For more information, see the Fusebox Integration Guide under Sale Transaction (02).
Sample Message
Request
The following table shows an example of a Sale Request message (from the POS to Simplify).
API Field #, Value | Description |
---|---|
0001,02 | Transaction Type |
0002,1.00 | Transaction Amount |
0007,55 | 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 |
0017,0.00 | Cash Back Amount |
0109,Term02 | Terminal ID (provided by Elavon) |
0110,205 | Cashier ID |
0201,0.00 | Tip Amount |
1008,ID: | Set to ‘ID:’ to request that an account Token be returned by Fusebox |
5071,xxx.. | Defines whether card and cardholder are present. See Simplify-Controlled Field Definitions. |
5104,xxx.. | Tip Settings. See Simplify-Controlled Field Definitions. |
8002,ONGUARD | Location Name (provided by Elavon) |
8006,TSTLA3 | Chain Code (provided by Elavon) |
Response
The table below is an example of a Sale Response message (from Simplify to the POS).
API Field #, Value | Description |
---|---|
0001,02 | Transaction Type |
0002,1.00 | Transaction Amount |
0003,ID:4476082153699999 | Account Token (returned by Fusebox) |
0004,0119 | Expiration Date (MMYY) |
0006,419039 | Authorization Code (returned by Fusebox) |
0007,55 | Transaction ID / Reference Number |
0009,001 | Fusebox – Host Batch number |
0011,xxx.. | User Data. See Simplify-Controlled Field Definitions. |
0013,022519 | Transaction Date (current date) – MMDDYY |
0014,105007 | Transaction Time (current time) – HHMMSS |
0017,0.00 | Cash Back Amount |
0030,1 | Fusebox – Online Indicator |
0032,022519 | Fusebox – Authorization Transaction Date |
0033,135016 | Fusebox – Authorization Transaction Time |
0035,5245 | Validation Code |
0036,018031513501628 | Host Transaction Identifier |
0037,0 | Fusebox - Authorizer |
0043,117595 | System Trace Audit Number |
0047,M;1;1;1;0;1;2;5;4;1;3;C;0;4 | POS Data Code |
0052,5 | Transponder / Proximity Indicator (0 = contact; 2 = contactless; 5 = swiped) |
0054,90 | POS Entry Mode |
0062,154 | Service Code |
0109,TERM02 | Terminal ID (provided by Elavon) |
0110,205 | Cashier ID |
0112,400 | Fusebox – Processor ID |
0115,010 | Transaction Qualifier (010 = credit; 025 = Private Label; 030 = debit; 040 = EBT; 050 = Gift Card; 085 = Cash Tender) |
0125,315175016 | Retrieval Reference Number (may need to appear on receipt) |
0126,2 | Track Indicator (may need to appear on receipt) |
0129,0 | Fusebox – Compliance Data |
0130,1.00 | Authorized Amount |
0140,USD | Merchant Currency |
0201,0.00 | Tip Amount |
0651, [see value below] | Reversal data (for reversal, if needed) |
0738,106781MMCC539137 Y 0225 | Recurring Compliance Data |
1000,VI | Card Type |
1001,VISA | Card Name |
1002,CERTIFICATION-VISA/ELAVON | Cardholder Name |
1003,0000 | Gateway Response Code |
1004,APPROVAL | Host Response Message |
1005,0010600008014593613999 | Merchant Number |
1008,************9999 | Masked Account Number (for printing on receipt) |
1009,AA | Host Response Code |
1010,COMPLETE | Gateway Response Message |
1012,0039 | Gateway Batch Number |
1021,N;N;N;N;Y; | Transaction permission flags received from Fusebox:
|
1200,0000AA | Issuer Network Information |
1339,00 | EMV Response Code |
1359,4 | EMV CVM Indicator |
4747,040311 | Third Party Interface POS Data Code |
5001,30101151010800;1640000800072727 |
|
5002,80649419 | Device Serial Number |
5004,OG | Encryption Provider ID |
5010,EMVDC0838 | EMV kernel version |
5070,xxx.. | Simplify Information. See Simplify-Controlled Field Definitions. |
5071,xxx.. | Defines whether card and cardholder are present. See Simplify-Controlled Field Definitions. |
5104,xxx.. | Tip Settings. See Simplify-Controlled Field Definitions. |
7007,1118074642168320 | Transaction Link Identifier (unique identifier to link transactions) |
8002,ONGUARD | Location Name (provided by Elavon) |
8006,TSTLA3 | Chain Code (provided by Elavon) |
0651,00103@;010011759603151751260000047170500000000000419041807417117596
Mifare Tap
The POS can activate Mifare tap by sending a request to Simplify with “M” or “m” in API 0003. For a valid tap, Simplify will extract the UID, and return it to the POS in the response as token 300 in Field 5001 (no Fusebox message). If API 5111 is present in the request, Simplify will display the text from this field instead of a configured message.
Sample Message
Request
See especially API 0003, 5111.
API Field #, Value | Description |
---|---|
0001,02 | Transaction Type |
0002,1.00 | Transaction Amount |
0003,M | “M” requests Simplify activate Mifare tap |
0007,368 | Transaction ID / Reference Number |
0011,xxx.. | User Data. See Simplify-Controlled Field Definitions. |
0013,030920 | Transaction Date (current date) – MMDDYY |
0014,095300 | Transaction Time (current time) – HHMMSS |
0017,0.00 | Cash Back Amount |
0109,RETERM1 | Terminal ID (provided by Elavon) |
0110,205 | Cashier ID |
0115,010 | Transaction Qualifier (010 = credit) |
0201,0.00 | Tip Amount |
1008,ID: | Set to ‘ID:’ to request that an account Token be returned by Fusebox |
5111,Please Tap $25 MiFare Card | Text to display while waiting for Mifare tap (if present, overrides default) |
8002,ONGUARD | Location Name (provided by Elavon) |
8006,TSTLA3 | Chain Code (provided by Elavon) |
Response
See especially API 0003, 1010, 5001.
API Field #, Value | Description |
---|---|
0001,02 | Transaction Type |
0002,1.00 | Transaction Amount |
0003,m | Mifare tap indicator (echoed from request) |
0007,367 | Transaction ID / Reference Number |
0011,xxx… | User Data. See Simplify-Controlled Field Definitions. |
0013,030920 | Transaction Date (current date) – |
0014,102821 | Transaction Time (current time) – HHMMSS |
0017,0.00 | Cash Back Amount |
0109,RETERM1 | Terminal ID |
0110, 205 | Cashier ID |
0115,010 | Transaction Qualifier (010 = credit) |
0201,0.00 | Tip Amount |
1003,0000 | Gateway Response Code |
1004,-99 | Host Response Message |
1008,ID: | Masked Account Number (for printing on receipt) |
1009,-99 | Host Response Code |
1010,*SLR MIFARE. | Simplify-Generated Response Message |
5001,300014042A18C25B6285 | Mifare UID (300 = Tag, 014 = Length of data) |
5002,07208937 | Device Serial Number |
5010,EMVDC0901 | EMV kernel version |
8002,SIMTEST | Location Name |
8006,TSTLA3 | Chain Code |
Airline Vouchers
Simplify supports airline QR vouchers as tender on camera-equipped PIN Pads. Supported Tran Types depend on the provider of the QR code. The use of QR vouchers can be enabled globally under configuration or for individual transactions by sending a “V” or “v” in API 0003. (Ignored if not camera-equipped.)
If QR voucher support is configured globally or enabled for an individual transaction, a voucher button will appear on the payment screen. Pressing this virtual button enables the camera and displays the camera (barcode) viewer used to scan the QR voucher code. If the customer scans the code, the PIN Pad will capture and read the code and send the payment data (embedded PAN and expiration date) to Fusebox in API 0003.
Simplify will set API 0647 (Partial Auth) to “1” in the Fusebox request message for all airline voucher transactions.