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 Responsemessage. These fields are:
-
Transaction Amount (Field 2)
-
Account Number (Token) (Field 3)
-
Reference Number (Field 7)
-
Terminal ID (Field 109)
Void Return Message
An example of a Void Return message (from the POS process to Simplify) is shown below.
| API Field #, Value | Description |
|---|---|
| 0001,17 | Transaction Type. A value of 17 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 data (token). This must be the same value as Field 3 of the Return response message. |
| 0004,1208 | 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 = Credit) |
| 8002,RETL01 | Location Name provided by Elavon. |
| 8006,TSTLAR | Chain Code provided by Elavon. |
Void Return Response
An example of a Void Return Response message (from Simplify to the POS process) is shown below.
| 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. |
| 0007,1025 | Transaction ID / Reference Number |
| 0013,092815 | Transaction Date (current date) – MMDDYY. |
| 0014,143515 | 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 |
| 5002,80378002 | Device Serial Number |
| 7007,1112011625131438 | Transaction Link Identifier |
| 8002,RETL01 | Location Name provided by Elavon |
| 8006,TSTLAR | Chain Code provided by Elavon |