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.
This Void Return message must include certain fields that were returned in the Return Response message. These fields are:
-
Transaction Amount (Field 2)
-
Account Number (Token) (Field 3)
-
Reference Number (Field 7)
-
Terminal ID (Field 109)
Sample Void Return Message
Request
An example of a Void Return Request message (from the POS process to the Simplify application) is:
API Field #, Value | Description |
---|---|
0001,17 | Transaction Type. A value of 11 indicates a Void Return |
0002,125.98 | Transaction Amount. This must be the same value as Field 2 of the Return response message |
0003,ID:1120106195107475 | Account token returned by Fusebox. This must be the same value as Field 3 of the Return response message. |
0004,1208 | Field 4 is the Expiration Date – MMYY |
0007,1025 | Transaction ID / Reference Number. This must be the same number as Field 7 of the Return response message |
0109,TERM1 | Terminal ID provided by Elavon. This must be the same number as Field 109 of the Return Response message |
0110,205 | Cashier ID |
0115,010 | Transaction Qualifier (010 = Original transaction was a Credit Tender) |
8002,RETL01 | Field 8002 is the Location Name |
8006,TSTLAR | Field 8006 is the Chain Code |
Response
An example of a Void Return Response message (from the Simplify application to the POS process) is:
API Field #, Value | Description |
---|---|
0001,17 | Transaction Type |
0002,125.98 | Transaction Amount |
0003,ID:1120106195107475 | This is the account Token returned by Fusebox |
0004,1208 | Field 4 is the Expiration Date – MMYY |
0007,1025 | Field 7 is the Transaction ID / Reference Number |
0013,092815 | Field 13 is the Transaction Date (current date) – MMDDYY |
0014,143515 | Field 14 is the Transaction Time (current time) – HHMMSS |
0052,3 | Transponder / Proximity Indicator (3 = contactless, 5 = swiped) |
0109,TERM1 | Terminal ID provided by Elavon |
0110,205 | Cashier ID |
0115,010 | Transaction Qualifier |
0126,0 | Track Indicator (may need to appear on receipt) |
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 |
7007,1112011625131438 | Transaction Link Identifier |
8002,RETL01 | Field 8002 is the Location Name |
8006,TSTLAR | Field 8006 is the Chain Code |