Return Message (Tran Type 09)

Simplify supports a Return message from the POS process.

Return Message

An example of a Return message (from the POS process to the Simplify application) is shown below.

API Field #, Value Description
0001,09 Transaction Type. A value of 09 indicates a Return.
0002,125.98 Transaction Amount.
0007,1025 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 Transaction Date (current date) – MMDDYY.
0014,143005 Transaction Time (current time) – HHMMSS.
0109,TERM1 Terminal ID provided by Elavon.
0110,205 Cashier ID.
0115,010 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 Location Name provided by Elavon.
8006,TSTLAR 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 Message

An example of a Return Response message (from the Simplify application to the POS process) is shown below.

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 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
8002,RETL01 Location Name provided by Elavon.
8006,TSTLAR Chain Code provided by Elavon.

Note: 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.

The online response includes two additional fields when the account data is entered manually and CVV2/ AVS prompting is enabled for the tender type used in the transaction (typically, for credit only).

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