--------------------------------------------------
Tyro Mobile Integration Terminal Message Simulator
--------------------------------------------------

Introduction
------------
The Tyro Mobile Integration Terminal Message Simulator can be used to aid in the development and testing of POS systems with the Tyro Pay@Table feature.  The simulator is a user-driven console application that sends simulated request messages to POS systems to allow testing of requests and responses.  Details of the integration specification can be found in the Tyro Integrated Pay@Table documentation.


Requirements
------------
* Java Runtime version 7.0 or above (download from http://www.java.com/download)


Launching the simulator
-----------------------
* Extract the simulator files to a directory
* Open a console window and navigate to that directory
* Open the tyro_mobile_integration_simulator.properties file in a text editor and customise the values in that file:
      tyro.merchant.id is the merchant's identifier
      tyro.terminal.id is the merchant's terminal identifier
      message.authentication.passphrase is the passphrase for MAC calculations, and should match the passphrase configured into the POS server (see Appendix A of the Tyro Integrated Pay@Table documentation for further details)
      pos.open.sales.url is the POS server URL for retrieving open sales
      pos.transaction.result.url is the POS server URL for posting approved transactions
      pos.diagnostics.url is the POS server URL for performing network diagnostics
      always.return.outcome indicates that all responses other than approved transactions results should be communicated back to the POS. Valid values are true and false (default).

* If your POS requires HTTP basic authentication also add the following two properties to tyro_mobile_integration_simulator.properties:
      http.basic.username is the username required by your POS
      http.basic.password is the password required by your POS

* Launch the simulator with the following command:
      java -jar tyro_mobile_integration_simulator.jar


Using the simulator
-------------------
* The simulator can be driven simply by selecting the relevant action from the menu displayed and by entering any information that the user is prompted for.
* The available functions correspond with the various request/response messages detailed in the integration documentation:
    - Diagnostics
    - Outstanding amounts
    - Transaction posts
  In addition, variations can be simulated by selecting different options and entering different data.
* The simulator logs the details of requests and responses to a file named "requestAndResponse.log", which will appear in the installation directory while the simulator is being used.  The contents of this log file can be used to diagnose any integration issues.
