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