Instructions for connecting the PAX A930 Android terminal to Torgsoft via the JSON protocol over Wi-Fi. The PAX A930 terminal can work with Torgsoft in two different modes:
1.
directly via JSON (COM/TCP) — this is the recommended and more stable option;
2.
via WebSocket and the «Cash Integration» app — this is an older and less stable method.
Before configuration, make sure to find out exactly which mode the bank has enabled.
This guide involves changing the settings of the bank terminal, network, and integration parameters in Torgsoft, so it must be followed carefully. If you confuse the connection mode, IP address, port, or protocol type, the terminal may stop accepting commands from the POS completely, and payments may start failing with timeouts or a DeviceBusy error. Before making any changes, make sure the bank has already told you which mode the terminal should operate in — direct JSON or WebSocket via the «Cash Integration» app. If you do not have access to the network settings or terminal parameters, contact the bank's technical support or your system administrator.
When you need to connect or reconfigure the PAX A930
•
For Wi-Fi or Ethernet connection: after changing the router, internet provider, or local network settings (when the IP address changes).
•
For USB connection: after the COM port changes. This happens when replacing the computer, using a different USB adapter, or if the terminal cable was simply plugged into another USB port and no one remembers where it had been connected before.
•
If communication errors occur («Device Busy», timeouts).
According to technical support practice, with a wired (USB) connection the COM port number is often changed automatically by Windows if the cable is plugged into a different socket or a new adapter is used. In that case, Torgsoft «loses» the terminal, so the settings must be updated. Changes for Wi-Fi/Ethernet concern network parameters only (IP, router, ports).
How to tell that the terminal is configured incorrectly
•
A DeviceBusy error («Device Busy») when attempting payment.
•
The message «Response timeout expired» appears (the money was debited, but the receipt was not printed).
•
The terminal does not «wake up» when you press the «Pay» button in the POS.
Why the PAX A930 loses connection to Torgsoft
•
The terminal's IP address changes (DHCP) after the router is rebooted.
•
The «Cash Integration» app is not running (or has been minimized) on the terminal.
•
Ports 3000/2000 are being blocked by antivirus software or the firewall.
•
The response timeout in Torgsoft settings is too short.
How to configure the PAX A930 to work with Torgsoft
1. How to prepare the network for the terminal
•
Connect the PAX A930 to the same Wi-Fi network as the computer running Torgsoft.
•
Mandatory: set a static IP address on the terminal or reserve it on the router by MAC address.
•
Risk: without IP reservation, the terminal's IP address may change after the router is rebooted or the DHCP lease expires, and the connection to Torgsoft will be lost.
2. Which connection method to use
Method 1: How direct JSON (COM/TCP) connection works
This is the modern and more reliable integration method. It allows Torgsoft to communicate with the terminal directly, without the need to install and continuously keep additional intermediary programs (for example, WebSocket servers) running on the cashier's computer.
•
What you need to do: contact your bank's technical support and ask them to configure the PAX A930 terminal to work specifically via the JSON (TCP/COM) protocol over Wi-Fi.
•
Network: be sure to reserve the terminal's IP address in your router settings so that it does not change after reboots.
•
In Torgsoft: in the bank terminal settings in Torgsoft, simply choose the JSON (COM/TCP) protocol and specify the IP address and port.
•
Benefits: this method works more reliably, allows the software to keep a detailed log of terminal transactions, and significantly reduces the risk of errors and lost connection.
Method 2: When WebSocket via «Cash Integration» is used
This method is still used, but technical support considers it outdated and less stable because it requires a WebSocket server to be running on the PC.
•
On the Android home screen of your terminal, open the «Cash Integration» app.
•
Select the type: «WIFI CONNECTION».
•
Check the status: a green connection indicator should blink on the screen.
•
Critically important (risks): the terminal must always remain with this app open in this mode. If the cashier exits to the Android home screen, accidentally minimizes the app, or if some other background operation starts on the terminal, an attempt to send an amount from Torgsoft will lead to a «Device Busy» error, and the program will wait a long time for a response.
Additional tip. If you are currently experiencing constant freezes or errors such as «DeviceBusy», Torgsoft technical support specialists strongly recommend reconfiguring your PAX A930 terminal from the old JSON (WebSocket) protocol to direct JSON (COM/TCP).
3. How to configure the terminal in Torgsoft
Menu: Settings → Parameters → Additional functions → Bank terminal.
The settings below depend on which connection type the bank configured for you:
Method 1: Settings for direct JSON (TCP/COM) connection — Recommended
This method is used if the terminal communicates with Torgsoft directly over the network.
•
Protocol type: choose JSON (COM/TCP).
•
IP address: enter the static IP address of the bank terminal itself, which you previously assigned to it in the router settings.
•
Port: port 2000 is usually used (or 2001, 2100, etc. — the exact port must be provided by the bank's technical support during configuration).
•
Merchant: leave it blank or specify 0. In the case of the PAX A930 terminal, merchant selection (if you have multiple merchant accounts) often happens directly on the terminal screen during payment.
Method 2: Settings via WebSocket/JSON (Legacy method)
This method is used if a background program from the bank (a WebSocket server, for example genericDriverJson or POSsvc.exe) must be running on the cashier's computer to communicate with the terminal.
•
Protocol type: choose WebSocket/JSON.
•
Host IP address: enter the IP address of the computer on which the WebSocket server is running (if the driver program is running on the same computer as Torgsoft, enter the local address, such as localhost or 127.0.0.1).
•
Port: always 3000 (this is the standard port for the WebSocket service).
•
Merchant: leave it blank or specify 0.
It is critically important not to confuse the IP addresses: for direct connection (Method 1), the terminal's IP is specified, while for WebSocket mode (Method 2), the IP of the computer running the driver is specified.
4. What timeout should be set
•
Set the «Response timeout» parameter to at least 180 seconds.
•
Why: Torgsoft receives a success signal only after the receipt is printed on the terminal. If the timeout is too short (60 s), the program will break the connection and cancel the receipt in the database even though the customer's money has already been debited.
5. What to consider when returning goods
•
Enable the option: «Use service».
•
A refund requires the RRN code (authorization code) from the paper sales receipt.
•
The cashier enters this code manually on the terminal keypad when prompted.
How to check that the terminal is working properly
1.
Make sure the green indicator is active on the terminal.
2.
Perform a test sale for UAH 1.00.
3.
The terminal should activate the card reader.
4.
After payment, the receipt in Torgsoft should close automatically.
How to avoid malfunctions with the PAX A930
•
Do not let staff play games or watch YouTube on the terminal (it is an Android device, but it must remain in POS mode).
•
Monitor the battery charge: below 15%, the Wi-Fi module may work unreliably.
What is important to remember
If the terminal is not responding, first check whether the «Cash Integration» app is running and whether the IP address has changed.
Go back to the previous step