Підприємець отримує від банку POS-термінал, на ньому можна вручну ввести суму і прийняти оплату карткою. Потім термінал намагаються підключити до Торгсофт, щоб сума покупки передавалася з програми автоматично, але каса не бачить пристрій або термінал не реагує на команду. У такій ситуації причина не обов'язково в Торгсофт: для інтеграції банк має окремо налаштувати термінал на роботу з касовою програмою. Тому ще до підключення підприємці запитують, що саме замовити в банку, як зрозуміти, що термінал готовий, і що перевірити, перш ніж змінювати налаштування програми.
Що означає «термінал підготовлений до інтеграції»
Звичайний POS-термінал може працювати самостійно: касир вводить суму на ньому вручну, покупець прикладає картку, банк проводить платіж.
При інтеграції з касою сума вводиться в Торгсофт. Програма передає її терміналу, а після оплати отримує від нього результат операції.
Щоб це працювало, мають збігтися три речі: банк налаштував термінал → Торгсофт підтримує цей спосіб обміну → термінал і касове робоче місце правильно з'єднані.
У довідці Торгсофт для окремих моделей прямо зазначено: до початку налаштування потрібно переконатися, що банк уже увімкнув режим касового суміщення і потрібний протокол. Наприклад, така вимога є для Newland N950 при підключенні через JSON.
Сам факт, що термінал приймає картки вручну, ще не підтверджує його готовність до роботи з касовою програмою.
Що потрібно сказати банку
При замовленні або переналаштуванні термінала не варто обмежуватися фразою «потрібен POS для магазину».
Скажіть: потрібен POS-термінал для інтеграції з касовою програмою Торгсофт. Потрібен режим касового суміщення. Уточніть, який протокол інтеграції підтримує ця модель і як вона підключається до каси — через USB/COM чи через мережу.
Якщо банк називає конкретний протокол, його потрібно звірити з протоколами, які підтримує Торгсофт.
Торгсофт працює з кількома варіантами інтеграції, тому не потрібно самостійно просити банк «прошити BPOS» або «увімкнути JSON» лише за назвою моделі. Один і той самий тип обладнання може використовуватися банками з різними налаштуваннями.
Яку інформацію потрібно отримати від банку до налаштування Торгсофт
До приїзду спеціаліста або початку налаштування варто знати:
-
точну модель POS-термінала;
-
який протокол касового суміщення на ньому активовано;
-
як він підключається до каси: USB/COM, Ethernet або Wi-Fi;
-
чи потрібні банківські драйвери або бібліотеки;
-
які мерчанти зареєстровані на терміналі;
-
якщо працює кілька ФОП — чи додані мерчанти для всіх потрібних підприємців;
-
чи налаштовані банком операції не лише оплати, а й повернення, якщо конкретна схема цього потребує.
Мерчант у цьому випадку — ідентифікатор торговця, за яким банк розуміє, на рахунок якого підприємця проводити операцію.
Торгсофт дозволяє пов'язувати мерчанти з відповідними розрахунковими рахунками. Інформацію про зареєстровані на терміналі мерчанти для підтримуваних інтеграцій можна отримати через дію «Отримати інформацію про термінал».
Як зрозуміти, що проблему потрібно спочатку вирішувати з банком
Є кілька характерних ситуацій.
Банк не може сказати, який протокол налаштовано
Якщо відповідь звучить як «термінал у вас працює, картки приймає», цього недостатньо.
Для Торгсофт потрібно знати саме спосіб інтеграції з касою. Якщо банк не може підтвердити, що касове суміщення активоване, спочатку потрібно вирішити це питання з еквайром.
Термінал працює вручну, але не реагує на касу
Наприклад, продавець може набрати 500 грн безпосередньо на POS і провести картку. Але коли Торгсофт намагається передати ті самі 500 грн автоматично, термінал нічого не робить.
Це одна з ознак, що потрібно перевірити:
-
чи ввімкнено касове суміщення;
-
чи вибраний правильний протокол;
-
чи працює потрібний канал зв'язку.
Не варто в такій ситуації одразу змінювати мерчанти, ПРРО або фінансові налаштування Торгсофт.
Для USB-підключення комп'ютер не бачить потрібного порту
Для тих інтеграцій, де POS підключається через COM/USB, у Windows має бути доступний відповідний COM-порт. Його номер можна побачити в «Диспетчері пристроїв». Саме цей номер потім використовується в налаштуваннях Торгсофт.
Якщо потрібного порту немає, спочатку потрібно перевірити кабель, драйвер і спосіб, у який банк налаштував термінал.
Але відсутність COM-порту не означає, що будь-який термінал «непідготовлений»: якщо модель налаштована для роботи через Ethernet або Wi-Fi, COM-порт їй взагалі не потрібен.
Для мережевого підключення невідомі IP-адреса і порт
При роботі через Ethernet або Wi-Fi Торгсофт звертається до термінала через мережу. Для відповідної інтеграції потрібно знати його IP-адресу та порт.
Наприклад, для B-POS через Ethernet у поточній довідці Торгсофт вказується IP-адреса термінала в локальній мережі та порт 2000.
Конкретні параметри залежать від протоколу. Тому не потрібно відкривати на роутері випадкові порти з інтернет-інструкцій — спочатку визначають, який саме протокол налаштований банком.
Чи можна перевірити готовність без проведення реального продажу
Після того як відомі протокол і параметри підключення, у Торгсофт можна виконати первинну перевірку.
Для частини інтеграцій доступна дія «Отримати інформацію про термінал». Якщо зв'язок налаштований правильно, Торгсофт отримує від пристрою інформацію, зокрема перелік зареєстрованих мерчантів.
Це корисна перевірка перед тестовою оплатою.
Але якщо інформацію отримати не вдалося, не можна автоматично робити висновок «банк не прошив термінал». Причиною також можуть бути:
-
неправильно вибраний протокол у Торгсофт;
-
неправильний COM-порт;
-
неправильна IP-адреса або порт;
-
відсутній драйвер;
-
проблеми локальної мережі;
-
термінал і комп'ютер знаходяться в різних мережах.
Тому спочатку визначають, де саме обривається зв'язок.
Що перевірити для Ethernet або Wi-Fi
Якщо банк підтвердив мережевий режим роботи термінала, потрібно перевірити локальну мережу магазину.
Комп'ютер із Торгсофт і POS повинні мати можливість обмінюватися даними. Для локальної каси це зазвичай означає, що вони знаходяться в одній мережі або між ними правильно організований доступ.
Також бажано, щоб IP-адреса POS не змінювалася після перезавантаження роутера. Інакше сьогодні Торгсофт звертається, наприклад, до 192.168.1.50, а завтра роутер видає терміналу іншу адресу — і зв'язок зникає.
Це вже налаштування мережі магазину, а не банківської прошивки термінала. У початковому матеріалі ці дві причини були змішані: динамічна IP-адреса сама по собі не означає, що банк неправильно підготував POS.
Якщо Торгсофт працює на віддаленому сервері
Про це потрібно повідомити ще до налаштування термінала.
При локальній роботі програма і POS знаходяться поруч. При RDP або VPS Торгсофт працює на сервері, а термінал стоїть у магазині.
У такому випадку особливо важливо заздалегідь визначити, чи підходить обраний банком спосіб підключення. Для частини сценаріїв зручніше мережеве підключення, а доступ між магазином і сервером організовують окремо.
Тобто банку та спеціалісту Торгсофт потрібно одразу сказати: «Термінал знаходиться в магазині, а Торгсофт працює на віддаленому сервері через RDP».
Це дозволяє не налаштовувати схему, яка добре працює на локальному ПК, але не підходить для віддаленої каси.
Якщо на одному терміналі працюють кілька ФОП
Це також потрібно погодити з банком до запуску.
У Торгсофт можна налаштувати кілька мерчантів і пов'язати їх із відповідними розрахунковими рахунками. Але Торгсофт не може самостійно створити нового торговця в банківському терміналі.
Спочатку банк повинен зареєструвати потрібні мерчанти на POS. Після цього вони налаштовуються у Торгсофт. Для підтримуваних протоколів їх перелік можна перевірити через інформацію про термінал.
Тому при двох ФОПах варто перевірити не лише тестову оплату першого підприємця, а оплату і повернення для кожного рахунку, який буде використовуватися на касі.
Що не потрібно робити до підтвердження від банку
Не варто навмання:
-
змінювати протокол у Торгсофт;
-
вводити випадкові номери портів;
-
змінювати службові параметри POS;
-
перепризначати мерчанти;
-
шукати «правильну прошивку» термінала в інтернеті.
У наданому чернетковому матеріалі, наприклад, пропонувалося визначати готовність за написами на екрані POS, використовувати універсальну утиліту BankTerminalTest.exe та трактувати окремі мережеві повідомлення як доказ того, що банк не налаштував термінал. У перевірених матеріалах Торгсофт я не знайшов достатнього підтвердження для таких універсальних правил, тому в робочу інструкцію їх краще не включати.
Як перевірити термінал перед початком роботи
Практична послідовність така:
-
У банку: підтвердити режим касового суміщення, протокол, тип підключення та мерчанти.
-
На робочому місці: перевірити, що термінал фізично або через мережу доступний відповідно до обраного способу підключення.
-
У Торгсофт: вибрати саме той протокол, який налаштований банком.
-
Перевірити зв'язок: за можливості отримати інформацію про термінал і мерчанти.
-
Провести невелику тестову оплату.
-
Провести тестове повернення, щоб одразу перевірити не тільки приймання грошей.

Якщо термінал не відповідає вже на етапі встановлення зв'язку, спочатку перевіряють протокол, драйвер або мережу. Якщо ці параметри правильні, а банк не підтверджує касовий режим, термінал потрібно переналаштувати на стороні банку.
Головне
Перед налаштуванням Торгсофт потрібно отримати від банку не просто «робочий POS-термінал», а термінал із налаштованим касовим суміщенням.
Підприємцю достатньо знати чотири речі: модель термінала → протокол інтеграції → спосіб підключення → мерчанти.
Якщо банк може чітко підтвердити ці параметри, далі можна налаштовувати Торгсофт. Якщо термінал лише приймає оплату вручну, але банк не може сказати, за яким протоколом він працює з касою, спочатку потрібно завершити налаштування на стороні банку.









Повернутися до попереднього кроку