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) |