Initiate HEM/IngEstate Message (Tran Type 36-07)
note
HEM and IngEstate are Ingenico PIN Pad management systems implemented by Elavon. Simplify is currently transitioning from the use of IngEstate to HEM.
Simplify supports an Initiate HEM/IngEstate message from the POS process. This message can be used to determine whether an updated package is available for downloading. Packages are used to download an updated Simplify application, parameter files, form files, etc.
This message can also be used to update the TMS Identifier, by sending it in API 5001 of the request (optional). See sample request below for details.
The Initiate HEM/IngEstate Response message includes a Status flag in API 5001 indicating whether the device was able to successfully communicate with HEM/IngEstate.
important
The Initiate HEM/IngEstate Message should only be sent when necessary and based on coordination with Elavon.
Field 5001 Format
Message | Description |
---|---|
(Generic format) | The format of this field is TTTLLLVVV…VV, where:
|
Request (optional) |
|
Response |
|
Sample Message
Request
An example of a possible Initiate HEM/IngEstate Request message (from the POS process to Simplify) is:
API Field #, Value | Description |
---|---|
0001,36 | Transaction Type. A value of 36 indicates a Non-Financial transaction |
0011,xxx.. | User Data. See Simplify-Controlled Field Definitions. |
5001,88100899990000 |
|
Response
An example of a possible Initiate HEM/IngEstate Response message (from Simplify to the POS process) is:
API Field #, Value | Description |
---|---|
0001,36 | Transaction Type. A value of 36 indicates a Non-Financial transaction |
0011,xxx.. | User Data. See Simplify-Controlled Field Definitions. |
5001,0070528007044000 |
|
5002,80378002 | Device Serial Number (if present) |
HEM/IngEstate Update Flow Chart
The HEM/IngEstate update process commanded from the POS operates as follows:
POS sends Initiate HEM/Ingestate (36-07) request to Simplify.
Simplify attempts to communicate with the HEM/Ingestate server.
- If not successful, Simplify sends Status Flag to POS in an Initiate HEM/Ingestate response:
- 01 = PIN pad busy.
- 02 = Comm error. PIN Pad may reboot.
- If successful, Simplify sends Status Flag = 00 in response. PIN pad displays ‘Connection’ and checks whether updated Simplify file are available.
- If no, Simplify reboots.
- If yes, Simplify download the available files from HEM/Ingestate, applies the updates, and reboots.