Return Message (Tran Type 09)

Simplify supports a Return message from the POS process.

Return Request

An example of a Return Request message (from the POS process to the Simplify application) is:

API Field #, Value Description
0001,09 Field 1 is the Transaction Type. A value of 09 indicates a Return.
0002,125.98 Field 2 is the Transaction Amount
0007,1025 Field 7 is a Transaction ID / Reference Number. (Must increment on every new request)
0011,xxx.. Field 11 is defined as User Data. See Appendix F for the use of this field
0013,092815 Field 13 is the Transaction Date (current date) – MMDDYY
0014,143005 Field 14 is the Transaction Time (current time) – HHMMSS
0109,TERM1 Field 109 is the Terminal ID provided by Elavon
0110,205 Field 110 is the Cashier ID
0115,010 Field 115 is the Transaction Qualifier (010 = Credit tender)
1008,ID: Field 1008 is set to the value ‘ID:’ to request that an account Token be returned by Fusebox
8002,RETL01 Field 8002 is the Location Nam provided by Elavon
8006,TSTLAR Field 8006 is the Chain Code provided by Elavon

Note: For the message from Simplify to Fusebox, Simplify will populate the Account Data fields(and PIN and KSN fields for debit transactions).

Return Response

An example of a Return Response message (from the Simplify application to the POS process) is shown below. The example was processed with Simplify configured to process Returns as non-EMV.

API Field #, Value Description
0001,09 Transaction Type
0002,125.98 Transaction Amount
0003,ID:1120106195107475 Account token returned by Fusebox
0004,1208 Expiration Date – MMYY
0007,1025 Transaction Reference Number
0011,xxx.. Field 11 is defined as User Data. See Appendix F for the use of this field
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 Field 115 is the Transaction Qualifier
0125,1201171752 Retrieval Reference Number (may need to appear on receipt)
0126,2 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)
1009,00 Host Response Code
1010,COMPLETE Gateway Response Message
5002,80378002 Device Serial Number
7007,1112011609581429 Transaction Link Identifier. A unique identifier to link transactions
8002,RETL01 Field 8002 is the Location Name provided by Elavon
8006,TSTLAR Field 8006 is the Chain Code provided by Elavon

Notes:

If the POS process times out waiting on a response to the Return message, the POS process should perform the Inquiry logic as described above. See Inquiry Message for details.

If the account data is entered manually and CVV2 / AVS prompting is enabled for the tender type used in the transaction (typically, for credit only), the online response will include two additional fields:

API Field #, Value Description
0050,**** CVV2 4 bytes (masked)
0700,94588 AVS 5-9 bytes (true ZIP code)