Void Return Message (Tran Type 17)
Simplify supports a Void Return message from the POS process if tokenization is implemented.
Customers might want to void a return transaction after it has been completed. The POS does this by sending a Void Return message to Simplify.
The following table shows a sample of fields in the Void Return message that may need to match fields in the original transaction.
API Field # | Description |
---|---|
0002 | Transaction Amount |
0003 | Account Data (token) |
0004 | Expiration Date |
0007 | Transaction ID / Reference Number |
0109 | Terminal ID |
8002 | Location Name |
8006 | Chain Code |
See the Fusebox Integration Guide under “Transaction Types” > “Void Return (17)” for more information.
Sample Void Return Request
An example of a Void Return Request message (from the POS to Simplify) is:
API Field #, Value | Description |
---|---|
0001,17 | Transaction Type. |
0002,125.98 | Transaction Amount. Must match the Return response. |
0003,ID:1120106195107475 | Account Token. Must match the Return response. |
0004,1208 | Expiration Date – MMYY. Must match the Return response (if present). |
0007,1025 | Transaction ID/Reference Number. Must match the Return response. |
0011,xxx.. | User Data. See Simplify-Controlled Field Definitions for the use of this field. |
0013,092818 | Transaction Date (current date) – MMDDYY |
0014,143520 | Transaction Time (current time) – HHMMSS |
0109,TERM1 | Terminal ID. Must match the Return response. |
0110,205 | Cashier ID |
0115,010 | Original transaction (010 = credit; 030 = debit) |
5071,xxx… | Defines whether card and cardholder are present. See Simplify-Controlled Field Definitions. |
8002,RETL01 | Location Name. Must match the Return response. |
8006,TSTLAR | Chain Code. Must match the Return response. |
Sample Void Return Response
An example of a Void Return Response message (from Simplify to the POS) is:
API Field #, Value | Description |
---|---|
0001,17 | Transaction Type |
0002,125.98 | Transaction Amount |
0003,ID:1120106195107475 | Account Token (returned by Fusebox) |
0004,1208 | Expiration Date – MMYY |
0006,028430 | Authorization Code (returned by Fusebox) |
0007,1025 | Transaction ID / Reference Number |
0009,1784 | Fusebox – Host Batch Number |
0011,xxx.. | User Data. See Simplify-Controlled Field Definitions for the use of this field. |
0013,092818 | Transaction Date (current date) – MMDDYY |
0014,143525 | Transaction Time (current time) – HHMMSS |
0030,1 | Fusebox – Online Indicator |
0032,092818 | Fusebox – Authorization Transaction Date |
0033,163528 | Fusebox – Authorization Transaction Time |
0035,50 | Validation Code |
0036,201902211655213 | Host Transaction Identifier |
0037,0 | Fusebox – Authorizer |
0043,013078 | System Trace Audit Number |
0047,2;1;0;1;0;0;6;5;4;1;2;4;0;4 | POS Data Code |
0052,5 | Transponder / Proximity Indicator (0 = contact; 2 = contactless; 5 = swiped) |
0054,01 | POS Entry Mode |
0109,TERM1 | Terminal ID |
0110,205 | Cashier ID |
0112,400 | Fusebox – Processor ID |
0115,010 | Transaction Qualifier (010 = credit; 030 = debit) |
0125,221165528 | Retrieval Reference Number (may need to appear on receipt) |
0126,0 | Track Indicator (may need to appear on receipt) |
0128,1.00 | Original Authorization Amount |
0130,1.00 | Total Authorized Amount |
0131,00 | CPS Total Incremental Auths Sent |
0132,0 | Authorization Reversal Sent |
0140,USD | Merchant Currency |
0651, [see value below] | Reversal data (for reversal, if needed) |
1000,VI | Card Type |
1001,VISA | Card Name |
1003,0000 | Gateway Response Code |
1004,ACKNOWLEDGED | Host Response Message |
1005,001060000801459411699 | Merchant Number |
1008,400555******4460 | Masked Account Number (for printing on receipt) |
1010,COMPLETE | Gateway Response Message |
5002,80378002 | Device Serial Number |
5071,xxx… | Defines whether card and cardholder are present. See Simplify-Controlled Field Definitions. |
7007,1112011625131438 | Transaction Link Identifier |
8002,RETL01 | Location Name |
8006,TSTLAR | Chain Code |
0651,00005A;010001307802212155280000062005900000610025028430905221013078