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 |