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 |