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