Simplify Introduction
On this page:
Simplify is Elavon’s PIN Pad-based application designed to process electronic payment transactions received from a Point of Sale (POS) or a Property Management System (PMS).
This document is a developer guide for customers interfacing their POS / PMS process to Simplify. It applies specifically to implementations that run Simplify on Ingenico PIN Pads using Voltage or On-Guard encryption, and send transactions to Elavon’s Fusebox host.
This document is reviewed for every application update and change to PCI P2PE requirements (at least annually) and updated as required.
See Usage for conventions used in this document.
Document Overview
This guide documents the Simplify API for POS/PMS (= POS below) developers interfacing with Ingenico devices.
Message Details provides details on message types sent between Simplify and the POS. This covers financial messages (message types which can have a financial impact) and various types of non-financial messages (no direct financial impact).
The start of this section provides generic Simplify-specific guidelines for handling financial messages.
For financial and other messages sent to Fusebox, this section includes references to Fusebox documentation for more information.
The subsection Non-Financial Messages defines the API for Simplify non-financial messages with Transaction Type 36.
note
Message samples under Message Details do not cover control characters, EMV fields, or offline and SAF processing. For more information, see under Message and Communications Protocols, EMV, and (depending on your implementation) either POS SAF Processing or On-Device SAF.
Additional messages, API fields and supported field values are documented in the following places:
- The following features and other topics are covered in separate sections:
- The following API fields are covered under Simplify-Controlled Field Definitions:
- API 0011 (User Data)
- API 5001 (Non-Financial Data)
- API 5070 (Simplify Load Information)
- API 5071 (Card/Cardholder Present?)
- API 5104 (Tip Prompting)
- API 1010 (Response Message) is documented in a separate section (together with response codes in API 1003 and 1004) for the case of Simplify-Generated Messages (and separately, Simplify-Generated Messages for On-Device SAF).
Supported Hardware
Attended Devices
Tetra
Simplify is supported for Version 25 and above on the following Tetra PIN Pads:
- Lane 3000
- Lane 5000
- Lane 7000
- Lane 8000
- Link 2500
- Move 5000
Telium
Simplify is currently available through Version 25 on the following Telium PIN Pads:
- iPP320
- iPP350
- iSC250 and iSC250 Touch
- iSC480 and iSC480 Touch
- iSMP4
- iWL252 (through build 88)
- iWL258 (through build 88)
Unattended Devices
Simplify is currently available for Version 29 on the following Tetra Unattended device:
- Self 4000
General Guidelines
POS development for Simplify should be based on the following set of principles:
PCI DSS Compliance: The customer is responsible for securely deleting the encrypted account data and making it unrecoverable after authorization using a method that supports PCI DSS secure delete standards (PCI DSS 3.0 Requirement 3.2).
The POS process should discard any message that does not correspond with the POS state.
The POS process should compare the Transaction ID / Reference Number (field 7) in the request and response. If the response doesn’t match the request, the message should be discarded.
If multiple POS workstations can be associated with a single PIN Pad, Simplify assumes that the POS process ensures there is only one outstanding transaction per PIN Pad. (This situation can occur under TCP/IP.)
Simplify can return encrypted account data to allow Stand-in processing by the POS. See POS SAF Processing for more information.
For support purposes, Elavon strongly recommends that the POS logs all messages received from and sent to Simplify.
API fields in messages sent to the POS will not necessarily appear in order by field number. E.g. the following sequence of fields is possible:
API Field #, Value Description 0001,36 Transaction Type 5001,010003888 Non-Financial Data 0011,14123010000?V102.18B01803 User Data For API fields that are defined as variable length, the POS must be able to handle data of varying lengths.
Elavon uses HEM/IngEstate for terminal maintenance and updates. Any issue with HEM/IngEstate connectivity will require shipping back the terminal for updates. Elavon recommends testing the connection to HEM/IngEstate during pilot.
Elavon uses Inquiry and Voids to recover from communication issues on Financial Messages. Please pay close attention when implementing Inquiry and Void logic.
Fields 13 (date) and 14 (time) are required in all financial requests. Time must be sent in military (24 hour) format.
To protect against EMV cards being left in the Simplify device, Simplify will not accept any message from the POS until the card is removed. An error message will be returned indicating that the card is still inserted.
If no response is received for a financial request, or if you need to start over for any reason, the POS should send a Cancel before sending another financial request.
The POS can activate Mifare tap by sending a request to Simplify with “M” or “m” in API 0003. For valid tap, Simplify will extract the UID, and send it to the POS in the response as token 300 in Field 5001 (no Fusebox message). See sample under Sale Message.
API 5001 contains data in TLV (Tag-Length-Value) format. The data (Value) is preceded by a 3-digit Tag (Token) identifying the data type and a 3-digit Length field defining the number of bytes of data. Multiple tags are concatenated with no delimiter.