Load Simplify File via Secure File Transfer Message (Tran Type 36-07)

Simplify supports a Load Simplify File via Secure File Transfer message from the POS process.

The POS system can send Simplify a Load Simplify File via Secure File Transfer Request message when the POS system wants Simplify to request a file download from a secure file transfer server. The file to be downloaded must be specified in the message from the POS. The location of the secure file transfer server is specified in the Simplify parameter files (by either IP address or host name). This message can be used to initiate a download of a new version of Simplify, new parameters, new form files, etc. In addition to the usual Tran Type 36 message fields, this Response includes the PIN Pad serial number in field 5002.

After a successful download, Simplify will reboot the PIN pad, without sending a response message to the POS. If Simplify cannot complete the download, Simplify will send a Load Simplify File via Secure File Transfer Response message to the POS system, containing a Status Flag indicating why the download could not be completed.

Field 5001 Format

MessageDescription
(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
  • TTT - Currently defined tags:
    • 007 – Download information
  • LLL - Must be 050.
  • VVV..VV = Name of file to be downloaded, including full path from secure file transfer home directory.
    Must be exactly 50 bytes ; if necessary, include padding.
Response (for failed download)
  • TTT - Currently defined tags are:
    • 007 – File download information
  • LLL - Must be 052.
  • VVV..VV
    • Bytes 1-50 = Name of download file. Echoed from Request, including any padding
    • Bytes 51-52 = Download Status Flag giving cause of failure:
      • 01 – Simplify is busy with customer interaction
      • 02 – Secure file transfer ]]parameter missing from parameter file
      • 09 – Error in secure file transfer

Sample Message

Request

An example of a Load Simplify File via Secure File Transfer Request message (from the POS to Simplify) is:

API Field #, ValueDescription
0001,36Transaction Type. A value of 36 indicates a Non-Financial transaction
0011,xxx..User Data. See Simplify-Controlled Field Definitions for the use of this field
5001,007050simpapp.tgz
  • 007 = Tag for File download information
  • 050 = Length of File name data (must be 50)
  • simpapp.tgz = name of download file(must be exactly 50 bytes)

Response

An example of a Load Simplify File via Secure File Transfer Response message (from Simplify to the POS) is:

API Field #, ValueDescription
0001,36Transaction Type. A value of 36 indicates a Non-Financial transaction
0011,xxx..User Data. See Simplify-Controlled Field Definitions for the use of this field
5001,007052simpapp.tgz
01
  • 007 = Tag for File download information
  • 052 = Length of data (must be 52)
  • simpapp.tgz = name of download file (must be exactly 50 bytes)
  • 01 = Download Status Flag (01 = Simplify busy with customer interaction)
5002,169018710PIN Pad serial number