Банк каже «драйверів немає» — як підключити банківський термінал до Торгсофт

Коли співробітники банку стверджують, що «драйверів немає», це часто означає відсутність комунікації між банківським софтом і обліковою системою. Для роботи з Торгсофт банку необхідно надати не лише "налаштований термінал", а й інтеграційний набір (бібліотеки, ПЗ).

Коли банк каже, що драйверів немає

• Під час налаштування касового суміщення (автоматична передача суми чека з Торгсофт на термінал).

• Після заміни термінала або перевстановлення Windows.

• Якщо банк видав пристрій, налаштований виключно в автономному режимі.

Як зрозуміти, що термінал не готовий до інтеграції

• Банк відповідає: «термінал працює сам по собі», «ми не даємо драйверів».

• У Диспетчері пристроїв Windows термінал відображається як Unknown device або з жовтим знаком оклику.

• Торгсофт видає помилку «Немає зв'язку з пристроєм» або «Бібліотеку не знайдено».

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

1. Відсутність апаратного драйвера (USB-to-Serial): Windows фізично бачить пристрій, але не знає, як з ним працювати (жовтий трикутник). Це рівень операційної системи.

2. Відсутність бібліотеки інтеграції (DLL): Windows бачить COM-порт, але Торгсофт не має "перекладача" для спілкування з терміналом. Це рівень програми.

3. Невірний режим термінала: на самому пристрої не активовано режим Ethernet, USB або Wi-Fi.

4. Брак прав доступу: бібліотека є, але вона не зареєстрована в Windows від імені адміністратора.

Як з’ясувати, чого саме не вистачає для підключення

Крок 1. Перевірка фізичного підключення (Рівень Windows)

1. Підʼєднайте термінал напряму до USB-порту материнської плати (без хабів).

2. Відкрийте Диспетчер пристроїв → Порти (COM і LPT).

3. Якщо є жовтий знак оклику: вам потрібен драйвер саме для кабелю/чіпа (часто це драйвери FTDI, Prolific або специфічні Verifone/Ingenico USB Driver). Цей драйвер має надати банк або його можна знайти за ID обладнання. Без цього кроку бібліотеки DLL не запрацюють.

4. Якщо пристрій відображається як COM-порт: фізичний зв'язок є, переходьте до кроку 2.

Крок 2. Запит та встановлення файлів інтеграції (Рівень Торгсофт)

Вимагайте у банку файли для конкретного протоколу:

• Протокол BPOS (ПриватБанк, Ощадбанк):

• Потрібно: бібліотека ECRCommX.dll 32-bit (версія 1.8.3.0+) та драйвер віртуального COM-порту.

• Протокол PosAPI (Райффайзен, Sense):

• Потрібно: бібліотека Posapi.dll.

• Протокол WebSocket / JSON (ПриватБанк — нові моделі PAX):

• Для USB: потрібна служба genericDriverJsonXXX.exe.

• Для Ethernet/Wi-Fi: Торгсофт може працювати напряму по IP.

• Протокол SSI_JSON (Monobank, ПКМБ)
• Торгсофт працює напряму, без інтеграційної бібліотеки

Крок 3. Аргументація для діалогу з банком

Якщо техпідтримка банку відмовляє:

Сценарій А (Апаратний драйвер):

«У диспетчері пристроїв термінал світиться як "Невідомий пристрій". Надайте драйвер USB-емуляції (Verifone USB / Ingenico USBCDC), щоб Windows побачила COM-порт».

Сценарій Б (Бібліотека інтеграції):

«Термінал підключено, порт є. Для роботи касового ПЗ нам потрібна бібліотека (.dll) під протокол [назва]. Надайте набір файлів для Windows-інтеграції».

Як перевірити, що термінал готовий до роботи

1.  Перевірити зв'язок з банківським терміналом з програми Торгсофт.

Як уникнути повторних проблем із підключенням

1. Вимкніть енергозбереження USB. У Диспетчері пристроїв → USB-контролери → кореневий концентратор → Властивості → Керування електроживленням → Зніміть галочку "Дозволити вимкнення цього пристрою...". Це попередить "відвалювання" термінала.

2. Використовуйте Ethernet (LAN) або Wi-Fi. Якщо є можливість, підключайте термінал через мережевий кабель до роутера. Це стабільніше за USB і не залежить від драйверів на СОМ-порт в системі Windows.