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. You need at least the Business plan.
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 register in the terminal (network interface). Be aware of dynamic IP address assignment! When connecting via TCP/IP, you must ensure that the computer has a static IP address.
3. Edit the pos.xml configuration file 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 macOS), and enter the port name:
<?xml version="1.0" encoding="UTF-8"?><settings> <cardAcceptanceDevicePort>COM3</cardAcceptanceDevicePort> <!--if the terminal is connected on COM3, or the TCP port number (e.g. 33300)--> <cardAcceptanceDeviceType>Ingenico</cardAcceptanceDeviceType> <!--the value does not matter--></settings>
4. After connecting, it is usually necessary to restart the terminal.
5. The terminal must be configured for communication via the serial port, or the TCP/IP address and port must be set.
6. The correct configuration can be verified by entering a payment in 1) Sales – Point-of-Sale Register, 2) Payment — the payment method must be set to credit/debit card, where pressing the 3) Complete button should send the transaction 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, you must manually set the permissions so that the file can also be read by the user account under which Flexi is running.