Довідкова інформація на зараз (04.05.2024) для налаштування банк. терміналу:
- Налаштування = 2000грн. разово за 1 термінал + 575грн.\міс. за 1 термінал

При зверненні клієнта з запитом на інтеграцію банківського терміналу з Syrve - потрібно:
1) Завести задачу по шаблону "01. Дежурному" з відповідною назвою.
2) Сповістити клієнта про деталі*, які йому необхідно вточнити перед подачею форми-заявки на інтеграцію.** Після цього задача з попереднього пункту не закривається.***
* Приклади таких "сповіщень":
https://t.me/c/1947060265/1060
https://t.me/c/1947060265/1063
https://t.me/c/1795488663/4668 (робочий чат з клієнтом)

** Клієнту передається "м`яч" + відбувається штатнє відпрацювання, як і з іншими задачами по шаблону "01. Дежурному".
Задача закривається у момент, коли ми маємо заповнену клієнтом форму-заявку на інтеграцію у PlanFix

1) З чим інтегруємося?
Протокол JSON:

• з підключенням по Wi-Fi
• з підключенням по Ethernet
• з підключенням по USB (від 20.09.2025р)
• USB-підключення не підтримується (застаріле)

Протокол POSAPI:

• з підключенням по Wi-Fi
• з підключенням по Ethernet
• з підключенням по USB

Протокол Bpos1:НЕ підтримується нашою інтеграцією

Протокол BPOS Light: (інформація від 17.11.2025)

• з підключенням по Wi-Fi
• з підключенням по Ethernet
• з підключенням по USB

2) Налаштування зі сторони банку (клієнт звертається у банк перед налаштуванням інтеграції):

• Налаштувати касове суміщення + показати, як його вмикати / вимикати (банк має пояснити це клієнту)
• Як та де подивитися ІР-адресу (нам це знадобиться на момент інтеграції, якщо термінал підключено по Wi-Fi або Ethernet).

3) Загальне налаштування
Для роботи з банк терміналом:
1. Встановити плагін BankTerminalConnector у папку плагінів SyrveFront.
1.1 Якщо будемо підключати Моно-термінал (протокол SSI ECR JSON) - треба встановити ось цей драйвер
1.2 Якщо це термніали на протоколі JSON (Newton/PAX) з підключенням по USB - додатково ніяких драйверів встановлювати не треба, система сама підхопить драйвер
2. Запустити програму BankTerminalConfigurator.exe яка знаходиться у папці плагіну (BankTerminalConnector) для попереднього налаштування підключення банк терміналів. Запускати фронт до цього не обов'язково. Програма сама створить необхідну папку конфігу.
3. Замовлення ліцензії для терміналу (розділ 4).

4) Програма конфігуратор
При запуску програми BankTerminalConfigurator буде створено по замовчуванню один тестовий термінал COM за протоколом Printec (термінали Verifone, Castles).
Розглянемо декілька можливих комбінацій налаштування.
1. Один термінал один ФОП. У клієнта один рахунок для надходження коштів, умовно немає поділу на ФОПів. Потрібно у конфігураторі просто додати термінал і не додавати мерчантів.
2. Один термінал, але декілька ФОП рахунків (касири до цього обирали кнопками при оплаті на рахунок якого підприємця оплачувати чек). У цьому випадку треба додати один термінал, і обравши його натисканням, нижче додати мерчантів.
3. Декілька терміналів, на кожному з яких по одному ФОП і в результаті ті ж декілька рахунків але на різних банк терміналах. Тут відповідно додаються декілька терміналів, і не редагуються мерчанти.
Ситуації коли є і багато терміналів і багато мерчантів розглянемо згодом.
Для того щоб касир більше не обирав вручну на терміналі на якого ФОПа оплатити і щоб запит оплати йшов на потрібний термінал є прив’язка. На скріншоті виділено налаштування які стосуються її:

“Тип привязки” який знаходиться справа - це глобальный параметр, у ньому можна обрати по якій ознаці відбувається привязка, По касі - означає що потрібно вказати назву точки продаж

при оплаті з якої автоматично буде йти запит оплати на відповідний банк термінал, або мерчанта. Якщо присутні мерчанти тоді у розділі мерчанта для кожного з них задається назва точки продаж, якщо на терміналі один мерчант заповнюється поле “Привязка терміналу”. Є також варіант привязки “По типу оплат”, це налаштування забезпечує вибір терміналу/мерчанта згідно назву типу оплати і відповідно припускає що буде додано декілька типів оплати. Таку ситуації розглянемо також пізніше.
Червоним на скріншоті знизу обведено розділ куди можна додати чи видалити термінал, а також обрати щоб редагувати. Назва терміналу формується з рядка підключення і протоколу підключення.

Якщо у клієнта на одному банк терміналі декілька ФОП тоді потрібно налаштувати розділ “Мерчанти”:

Попередньо виділивши термінал на якому потрібно редагувати мерчантів, ввести ІД (цей ід потрібно скопіювати у логу plugin-BankTerminalConnector.log після додавання терміналу у конфігураторі і запуску фронту) ось на скріні:

Попередньо виділивши термінал на якому потрібно редагувати мерчантів, ввести ІД (цей ід потрібно скопіювати у логу plugin-BankTerminalConnector.log після додавання терміналу у конфігураторі і запуску фронту) ось на скріні:

Для того щоб додати можливість вибору банківського терміналу в межах однієї каси потрібно:
1) Додати 2 банківських термінали у програмі BankTerminalConfigurator.
2) Кожному банківському терміналу потрібно прописати привязку терміналу(у даному випадку назву каси, вона повинна бути одинаковою для двох терміналів).

3) Дати імя банківським терміналам у конфігу додавши кожному поле "Name" та ввівши туди його назву.
Приклад робочого конфігу:

Якщо все зроблено вірно то після вибору правильного типу оплати та натискання кнопки "Оплатити" з'явиться вікно з іменами цих банківських терміналів, та, при виборі, на потрібному банківському терміналі з'явиться віконце для оплати

Протокол: “Приват Json” для терміналів PAX, або Printec для терміналів Verifone чи Castles.
Тип підключення: Мережа якщо термінал підключений до локальної мережі через ethernet чи Wi-Fi, або COM якщо термінал по USB (у цьому випадку потрібно встановити драйвер терміналу).
Рядок підключення: задається у форматі “COM7” у випадку COM, або вказується ір та порт через дві крапки: “192.168.1.111:5001”, для протоколу Printec (POSAPI) порт завжди 5001, для PAX зазвичай порт 2000, але можуть міняти, потрібно це уточняти в банку.
Кнопка “Підключитись” тестова.
Поле “Ліцензія” наразі не використовується.
Галки проставляти не потрібно. Це тестовий функціонал.
Для збереження налаштувань перед виходом кнопка “Зберегти налаштування”. Якщо зберігати не потрібно можна просто вийти і зайти повторно.
Приклад робочого налаштування:

5) Налаштування типу оплати у SyrveOffice

Наступний етап налаштування типу оплати у SyrveOffice, за шаблоном:
Тип - “Зовнішній тип оплати”
Безготівковий тип - “Банківські термінали” (цей варіант з'являється після запуску плагіна). Усі інші параметри довільні, задавайте за потребою.

6) Замовлення ліцензії для терміналу
У логу плагіна після налаштування терміналу знайти запис: “Сheck License”, у логу буде виглядати наприклад так: Сheck License 450-011-791
де 450-011-791 і є серійний номер для замовлення ліцензії.
У тому ж логу нижче можна перевірити її наявність.