Skip to main content

Payment Terminal Setup

Flexi System Supports the Ingenico Payment Terminal for Windows, Linux, and Mac OS X Platforms.

Written by Petr Pech

The connection can be established via a serial interface (RS-232) or a network cable (RJ45).

Procedure

1. Verify that your license supports a payment terminal. At minimum, the Business plan is required.

2. Connect the terminal and find out the name of the port it is connected to (serial interface). Alternatively, configure the TCP/IP address and port of the computer running the point-of-sale system in the terminal (network interface). Be aware of dynamic IP address assignment! When connecting via TCP/IP, a static IP address must be assigned to the computer.

3. Edit the configuration file pos.xml located in the directory c:\Program Files (x86)\Common Files\WinStrom\ on Windows (if the folder is missing, proceed to the end of this guide — Note) (alternatively /etc/flexibee/ on Linux or /Library/Application Support/FlexiBee/Default/ on Mac OS X), where you enter the port name:

<?xml version="1.0" encoding="UTF-8"?><settings>  <cardAcceptanceDevicePort>COM3</cardAcceptanceDevicePort>  <!--pokud je terminal pripojen na COM3, pripadne cislo portu TCP (napr. 33300)-->  <cardAcceptanceDeviceType>Ingenico</cardAcceptanceDeviceType>  <!--na hodnote nezalezi--></settings>


4. After connecting, it is usually necessary to restart the terminal.

5. The terminal must be configured for serial port communication, or the TCP/IP address and port must be set accordingly.

6. The correct configuration can be verified by entering a payment in 1) Sales – Point of Sale, 2) Payment, where the payment method must be set to credit card, and after pressing the 3) Complete button, the transaction should be sent to the payment terminal.

  • TCP protocol (UDP is not supported).

  • One user-definable port (any port), e.g. 33000 (must be allowed through the firewall).

If the WinStrom folder is missing from c:\Program Files (x86)\Common Files\WinStrom\, you can create it manually. Then place the pos.xml file into the newly created folder. Flexi will locate the configuration automatically.

The path to the configuration file is visible in Flexi via Help – About ABRA Flexi – Application Details.

Windows may require administrator privileges. In that case, permissions must be set manually to allow the user account under which Flexi is running to read the file.

Did this answer your question?