Мережеві вимоги для банківського POS-термінала: IP, порти, firewall

Ця інструкція описує мінімальні мережеві вимоги для стабільної роботи банківського POS-термінала у парі з програмою Торгсофт. Застосовується при локальній роботі, віддаленому доступі (RDP) та використанні термінальних серверів.

Коли потрібно перевіряти мережеві налаштування термінала

• Термінал підключений по Ethernet або Wi-Fi (TCP/IP).

• Каса або база даних працює на віддаленому сервері (RDP).

• Після перезавантаження роутера або відключення світла зникає звʼязок з терміналом.

• Використовується суміщення каси з терміналом (ECR).

Як зрозуміти, що проблема в мережі або доступі до термінала

• Повідомлення «Немає звʼязку з терміналом» або «Пристрій не знайдено».

• Оплата карткою не проходить, зʼявляються тайм-аути.

• Термінал працює локально, але не відповідає з сервера.

• Звʼязок зникає після кожного перезапуску мережевого обладнання.

• Виникає «Помилка №3» або роздруковується чек «АНУЛЬОВАНО» (особливо при RDP-підключенні через USB/COM).

Чому Торгсофт не бачить банківський термінал

• Динамічна IP-адреса термінала — після перезавантаження змінюється внутрішній IP.

• Відсутня зовнішня (біла) статична IP-адреса на роутері магазину — сервер не може ініціювати зʼєднання з терміналом.

• Не відкриті або не прокинуті порти на роутері чи у firewall.

• Різні підмережі без VPN — каса і термінал не «бачать» одне одного.

• Блокування портів або видалення/карантин виконуваних файлів програми Торгсофт антивірусом (Avast, Windows Defender, 360 Total Security).

Як налаштувати мережу для банківського термінала

1. Статична IP-адреса

• Внутрішня (LAN, обовʼязково). У налаштуваннях роутера зафіксуйте IP для термінала через DHCP reservation (привʼязка MAC-адреси до IP). Альтернатива — задати статичний IP безпосередньо в меню термінала (наприклад, для PAX чи Verifone). Зверніть увагу, що при повному скиданні роутера до заводських налаштувань ця прив'язка зникає.

• Зовнішня (Public / White IP). Обовʼязкова на стороні магазину, якщо сервер ініціює зʼєднання до термінала. Якщо інтернет працює через мобільний 3G/4G роутер (наприклад, LifeCell, Київстар), провайдер за замовчуванням видає «сіру» (внутрішню) IP-адресу. Прокидання портів у такому випадку не працюватиме, послугу «Зовнішня статична (біла) IP-адреса» потрібно замовляти у провайдера окремо.

2. Прокидання портів (Port Forwarding) та протоколи 

Налаштуйте на роутері магазину перенаправлення з зовнішнього порту на зафіксований внутрішній IP термінала. Налаштування залежать від протоколу:

• BPOS (ПриватБанк, Ощадбанк тощо). Типовий порт — 2000. Іноді банк може переключити роботу на порт 2100.

• JSON (WebSocket). Використовується локальний сервер (файл genericDriverJsonETH.exe або genericDriverJsonUSB.exe), який завжди працює по порту 3000.

• JSON (COM/TCP). Торгсофт звертається напряму до IP-адреси термінала, зазвичай використовується порт 2000 або 2100.

• PosApi (Verifone Sense/Альфа-Банк). Типовий порт підключення через Ethernet — 5001.

• InpasEcrCom (МР Банк, ПУМБ, ТАС тощо). Особливість протоколу в тому, що термінал шукає касу, а не навпаки. В налаштуваннях термінала має бути прописана IP-адреса компʼютера (каси), а на самому ПК (роутері) потрібно відкрити вхідний порт 5555.

Кілька терміналів в одній мережі

Для кожного термінала резервується власна внутрішня IP-адреса, а на роутері налаштовується окремий зовнішній порт (наприклад: зовнішній 2001 → на внутрішній IP першого термінала (порт 2000), зовнішній 2002 → на внутрішній IP другого термінала (порт 2000)).

3. Firewall та антивірус 

На компʼютері або сервері з Торгсофт:

• Створіть Inbound та Outbound rules у Windows Firewall (Брандмауері) для дозволу по протоколу TCP/UDP.

• Відкрийте порти терміналів (2000, 3000, 5555 тощо) та порти для роботи самої програми: 1433, 1434 (SQL Server), 6001 (сервер додатків Торгсофт).

• Дозвольте RDP-з'єднання (за замовчуванням TCP 3389 або змінений порт).

• Додайте всю папку програми Торгсофт та виконувані файли (torgsoft.exe, TorgsoftLicenseService.exe) у винятки антивіруса (Avast, Defender, 360 Total Security), оскільки вони можуть помилково блокувати служби або видаляти файли в карантин.

4. Мережеві вимоги банку

• Каса і термінал мають бути в одній підмережі.

• Якщо вони фізично в різних локаціях — обов'язково використовуйте VPN.

• Для стабільності рекомендовано дротове підключення (Ethernet). Wi-Fi допускається лише за умови стабільного сигналу та правильної конфігурації.

5. USB / COM та RDP (обмеження)

• При використанні підключення USB/COM через віддалений робочий стіл (RDP) часто виникає «Помилка №3» або друкується чек «АНУЛЬОВАНО».

• Банки не гарантують коректну роботу в такій схемі.

• Рішення: для стабільної роботи термінал слід перевести на мережеве підключення (TCP/IP) та звернутися в підтримку банку для налаштування протоколу (наприклад, BPOS Ethernet).

Як перевірити, що термінал доступний по мережі

1. Ping: виконайте ping <IP_термінала> — має бути відповідь від пристрою.

2. Перевірка порту: telnet <IP> <PORT> — перевіряє, чи відкритий порт і чи відбувається підключення без помилок.

3. Утиліти від банків: завжди перевіряйте роботу термінала незалежно від Торгсофт. Для протоколів BPOS, PosApi, SSIAxECR використовуйте утиліту BankTerminalTest. Для WebSocket — відкрийте в браузері http://localhost:3000/, де має з'явитися WEB-інтерфейс «Generic PoS driver». Для InpasEcrCom використовуйте InpasEcrComTest.exe.

4. Тест у Торгсофт: Налаштування → Параметри → Додаткові функції → Банківський термінал → натисніть «Отримати інформацію про банківський термінал».

5. Тест оплати: проведіть тестову оплату на 1 грн (або 0.01$) та зробіть повернення.

Як уникнути втрати зв’язку з терміналом

• Завжди фіксуйте IP-адреси обладнання (через налаштування роутера або самого термінала).

• Не використовуйте Wi-Fi для критичних кас без резерву; якщо використовуєте — переконайтеся у відсутності конфліктів у мережі.

• Документуйте порти, IP та MAC-адреси для кожної торгової точки.

• Після заміни або повного скидання роутера — обов'язково перевіряйте фіксацію IP (DHCP reservation) та port-forwarding, оскільки вони злітають.