Initiate HEM or IngEstate Message (Tran Type 36-07)

error_outline
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 field 5001 of the request (optional). See sample Request below for details.

The Initiate HEM/IngEstate Response message includes the PIN Pad serial number as well as a Status flag indicating whether the PIN Pad was able to successfully communicate with HEM/IngEstate.

error_outline
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:
TTT is a Tag
LLL is the length of the data.
VVV..VV is the data
Request (optional) TTT - Currently defined tags:
881 = New TMSID
Response TTT - Currently defined tags are:
007 – Download information
LLL must be 052
VVV..VV
Bytes 1-50 = Padded PIN Pad Serial Number (must be 50 bytes)
Bytes 51-52 = Status Flag
00 – Request successfully communicated to HEM/IngEstate
01 – Simplify is busy with customer interaction
02 – Parameter missing from parameter file

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 Field 11 (User Data) .
5001,88100899990000 881=Tag for TMSID
008=Length of Data
99990000=new TMSID

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 Field 11 (User Data) .
5001,0070528007044000 007 = Tag for File download information
052 = Length of data (must be 52)
80070440 (plus blanks) = padded PIN Pad Serial # (must be exactly 50 bytes)
00 = Status Flag (00 = Simplify successfully communicated with HEM/IngEstate)

HEM/IngEstate Update Flow Chart

The HEM/IngEstate update process commanded from the POS operates as follows: