The Tyro Terminal Adapter exposes a very simple API to enable integrators to programmatically initiate financial requests on the Tyro Terminal.

The programmable interface raises certain events to indicate important milestones in the progress of a transaction. Coupled with the fact that the API methods are non-blocking, the existence of these events should mean that calling the Tyro Terminal Adapter from most windows based environments is simple and convenient.

The task-based operations use callbacks to return any data.

Please refer to the "API" section below for more details on the function of this API in depth, and for example on how this may be called.

Configuration

The Tyro Terminal Adapter distribution includes a standalone application which is used to set configuration. This includes being able to configure Merchant ID (MID) and Terminal ID (TID) information, perform Pairing operations, and set whether receipts will be printed on the Tyro Terminal, or whether printing will be managed by the POS.

In-progress Transaction GUI

The Tyro Terminal Adapter displays a very neat, simple window during the course of a transaction to allow the POS system operator to follow the course of and interact with a transaction. Immediately, it presents the POS operator with an indication of the state of the the transaction. During the course of the transaction, the operator may cancel the transaction. Also, throughout the transaction the operator may be presented with questions that are being asked on the terminal, which may be answered from the POS by tapping buttons that will appear.

As activity may take place on the terminal at the same time as the POS operator is sending messages to the terminal, the The Tyro Terminal Adapter also takes care of ensuring that it always presents the most up to date information available from the terminal. For instance, if a question is being asked on the terminal, and can be answered on both the terminal and the POS system, and is subsequently answered on the terminal, the Tyro Terminal Adapter will make sure that the question is no longer presented to the operator.

Security

The API includes features that protect the integrator, merchant, Tyro and the merchants customer from fraud.

The integrity of all communications across the network during transactions are ensured, so there is no chance that false responses might be received from the Integration Server. All communications between the Terminal Adapter and the Integration Server are SSL secured and verified, to ensure that the POS system is communicating with Tyro. In addition, the pairing process between the POS system and the Terminal ensures that the terminal has control over who has access to it. The integrity of the codebase during installation and updates is also guaranteed, to ensure that malicious code is not installed. Each time an installation or an update is performed, the downloaded code is verified to have come from Tyro payments.

Detailed Onsite Error Reporting

The Tyro Terminal Adapter keeps a detailed log of its activity as it performs its functions. This log can be readily interpreted by support staff to determine what might have gone wrong during a transaction.

Printing

The Tyro Terminal Adapter supports printing either being performed on the Tyro Terminal during a transaction, or via the POS (referred to as "printing locally"). The mechanism by which printing via the POS occurs is covered in the API section, below. Integrated receipt printing is now mandatory with exceptions being provided only where dedicated POS printers are not typically available. This is because not all of our terminals come with a receipt printer attached to the terminal and we prefer that POS systems that integrate with Tyro to be able to work with all of our terminals.