TransaxPay

In this article

Setup

Settings

Capabilities

This article describes the implementation of the TransaxPay plugin in the LS Pay engine.

Setup

Note: TransaxPay does server maintenance every Wednesday from around 2:00 pm - 4:00 pm. During this time transactions on the PED will be declined with an error message saying Transaction declined. No server is available at this time.

PED - P400

Note: The Server IP and Port should keep the default values (127.0.0.1 and 8800) unless you have downloaded and set up the software from TransaxPay on another device.

  1. Connect the PED to the network.
    Note: We recommend to assign a static IP address to the PED and to the device running the POS.
  2. Open device settings by pressing 5 + ENTER at the same time.
  3. Enter the password 166831 to enter the settings menu.
  4. Press 4 to open the POS IP Address setting and enter the IP address of the device running the POS.
    Note: If the POS IP address has segments with less than 3 numbers, prefix the segment with 0s. Press ENTER once you have added the IP address.
  5. Press 5 to open the POS Port setting, and enter a port number. The default is 9900, do not use 8800 or 8900. Press ENTER once you have configured the port number.
  6. Press 7 to restart the PED.

Hardware Station settings

  1. Configure the IP address setting of the plugin with the IP address of the PED.
  2. Configure the main port setting of the plugin with port number 8900.
  3. Configure the secondary port setting of the plugin with the port number you used in step 5 in the section above.
  4. Configure the additional IP address setting to set the IP address that the service will listen for device messages on.
    • If you are using a PED with the EFT software embedded, this should be set to the IP address of the device running the POS.
    • If you are using the stand-alone EFT software on the same machine running the POS, this should be set to 127.0.0.1.
  5. Configure the connection type setting of the plugin to TCP.

Troubleshooting

Communication Error

If you get the below card service response from the terminal, check the following:

  • Verify that POS IP and POS port settings on the terminal match the IP address of the device running the POS and the port number of the plugin settings.
  • Try increasing the timeout setting for the plugin.

This error is typically caused by the terminal sending device requests (status updates, receipt printing requests, and so on) and not getting a response back in time from the POS.

Copy 
<?xml version="1.0" encoding="UTF-8"?>
<CardServiceResponse xmlns="http://www.nrf-arts.org/IXRetail/namespace"
        RequestType="CardPayment"
        WorkstationID="LSRetailPOS"
        RequestID="0288136007"
        OverallResult="Failure"
        CustomerNotPresent="false">
    <PrivateData>Communication Failure</PrivateData>
</CardServiceResponse>

Settings

  • Connection Type: Determines how the POS will connect to the PED. Currently only TCP connections are supported.
  • IP Address: The IP address of the PED.
  • Main Port: The TCP port of the PED. The default is 8900, you will need to contact TransaxPay support to change this as it is hardcoded in a configuration file on the PED.
  • Secondary Port: The TCP port for the POS to listen for incoming requests from the PED.
  • Timeout: Sets the amount of time in seconds the POS should listen for a response from the PED after sending a request before terminating the connection.

Capabilities

EFT (Electronic Fund Transfer)

  • Purchase
    • Returns a purchase response.
    • The response only shows authorization statuses of Approved, Cancelled, or Declined.
  • Refund
    • Returns a refund response.
  • Void
    • Returns a refund response.
    • Void functionality is not supported by TransaxPay. All void requests are treated as refund requests.
  • GetLastTransaction
    • Returns a response containing the information from the last response the PED sent to the POS.

Barcode Scanner

  • Not implemented.