Building a Reference Installation

The steps to building and validating a reference installation are detailed below. The desired outcome is to produce a directory, YESEFT, containing all the required IPC components. This directory can then be copied to all of the tills in the estate.

Pre-requisites

The process described must be implemented on a reference till that will have the same environment as the production tills in the estate.

Java path

The IPC installer creates scripts used at the IPC startup containing references to the full path of JRE. The location of JRE should be exactly the same for the reference till as for the tills in the estate.

YESEFT path

The IPC installer creates scripts used at the IPC startup. The scripts reference the full path of the directory (the YESEFT directory) in which it is directed to install the IPC. The YESEFT directory contains all components of the IPC and can be copied to other tills in the estate. The YESEFT directory’s full path must be copied on to the destination till exactly as it is on the reference build.

PED Connection Options

For serial and USB connected PEDs, the IPC is configured to use particular COM ports in one of its configuration files.

At startup, the IPC sends a command to the PED on the configured port and will continue upon receipt of the expected response. If no response or an unexpected response is returned, the IPC will search for other COM ports available.

For each COM port detected the IPC will send a PED command and wait to receive the expected response. The IPC will continue this process until a PED is detected, or has cycled through all available COM ports.

Best practice: You should install the PED for new or rebuilt tills on the same COM port as installed on the reference build to reduce the IPC installation time and startup.

USB Driver

For your USB connected PED only, you will need to install a specific USB driver provided by the PED manufacturer.

Note: You must not use a cable converter, such as serial to USB, to convert the connection type.

Create a Reference Build

Install the supplied the IPC

The IPC installer will create a YESEFT folder in your selected location.

Configure IPC

Run the YESEFTConfig.bat to make any needed changes.

Configuration parameters are specified in theIPC Configurationsection.

These parameters should be reviewed and set appropriately:

  • Environment (POS/Semi-Attended)

  • PED type

  • PED connection port

  • Socket ports

  • Receipt port

  • Print merchant receipt

  • Referral Mode

  • Offline stored transaction limit.

Further parameters are available for configuration depending on your needs.

Once the configuration parameters are set as desired, the reference YESEFT directory is complete.

Warning: Never configure the Reference YESEFT directory on the reference till with test or live MID and TID details.

Validate the IPC Reference Build

To validate your reference build you will require a second test till (secondary till).

This validation process requires the till be connected to a test TID to prove that all the IPC components and parameters are correct and the IPC is able to initialise and complete a transaction.

To complete the steps to validate the reference build you need:

  • A PED powered up and connected to the secondary till

  • Internet connectivity to be available to secondary till on these URLs :

    • primary: https://total1.worldpay.com/soap/servlet/rpcrouter

      https://194.72.158.227/soap/servlet/rpcrouter

    • secondary: https://total2.worldpay.com/soap/servlet/rpcrouter

      https://80.69.5.198/soap/servlet/rpcrouter

Copy the YESEFT Reference directory to the secondary till

  1. For integration testing you will have been supplied a test terminal.emv.properties file by Worldpay. Copy this file into the YESEFT directory you have created on the secondary till.

    Note: This step is only needed when working with a test TID and not needed for production installation of the IPC

  2. Configure IPC for the test EMBOSS MID and TID by running EMBOSS-Setup.bat. For a scripted installation process use EMBOSS-Setup-NC.bat.

  3. Use StartPOSServer.bat to start the IPC.

  4. IPC pulls the configuration details from Worldpay for the specified TID.

    Note: If you receive the error ‘Multiple Terminal Installation’, see theMultiple Terminal Installationtroubleshooting section.

  5. Test the IPC on the secondary till by performing card transactions such as a sale and refund with a chip card for online approval, and a sale and a refund with a contactless card.

  6. Once the Reference build is correct, zip the YESEFT directory from the reference till and copy to all of the tills in the estate (renaming any previously existing YESEFT directory to a backup name).