Device Manager(далі ДМ) додатково(окрім ПРРО) вміє працювати різними типами пристроїв, а саме:
З підключеними пристроями у зв'язці з ПРРО, можна взаємодіяти як окремо(окремий API запит на кожен пристрій) так і комплексно(один запит для оплати по терміналу + фісказації + друку)
Детальніше:
ДМ для підключення підтримує наступні протоколи пристроїв залежно від того під керуванням якої операційної системи працює додаток(станом на травень 2024 року)
Назва протоколу | Опис | Підтримка на windows | Підтримка на linux |
---|---|---|---|
ECS/POS | Протокол для роботи з принтерами чеків. Підтримуються всі чекодруки в яких реалізований даний протокол. Основних спосіб роботи з принтерами так як є найстабільнішим. Можливість відкривати грошовий ящик. | Підтримується Інтерфейси: Ethernet/wi-fi USB COM Bluetooth |
Ethernet/wi-fi USB |
SSI JSON | Протокол для роботи з терміналами від компанії SSI. Протокол надає можливість використовувати термінал як принтер чеків. Підтримуються всі моделі терміналів які мають встановлене пз від виробника SSI. | Підтримується Інтерфейси: Ethernet/wi-fi |
Ethernet/wi-fi |
Universal Print | Внутрішній протокол ДМ для роботи з принтерами які підключені до системи на windows. Може працювати з будь яким принтером що заведено в системі в списку пристрої/принтери та сканери. | Так. Вимагає підключеного принтеру до системи. | Наразі не підтримується |
Screen | Внутрішній протокол ДМ для роботи з віртуальним принтером. Віртуальний принтер дозволяє відображати чек на екрані замість друку на фізичний принтер. | Ethernet | Наразі не підтримується |
Windows printer | Внутрішній протокол ДМ для роботи з принтерами які підключені до системи на windows. Застаріла версія Universal Print, більше не підтримується із за проблем з друком чеків на деяких моделях принтерів, існує лише для сумісності з попередніми версіями додатку. | Так. Вимагає підключеного принтеру до системи. | Не підтримується |
Інформація в таблиці в колонці "Перевірені моделі терміналів" включає в себе моделі терміналів які були протестовані при розробці.
Перелік терміналів які працюють є більшим ніж зазначені моделі, все залежить від встановленого банком протоколу для взаємодії з терміналом.
Назва банку | Протокол | Опис | Перевірені моделі терміналів | Підтримка на windows | Підтримка на linux |
---|---|---|---|---|---|
Приватбанк | PrivatBankJSON | Протокол для роботи з терміналами Приватбанку що використовують json протокол. | 1) PAX A930 2) Ingenico ICT220 3) Ingenico desk/3200 4) Verifone VX520 |
Підтримується Інтерфейси: Ethernet/wi-fi, USB, COM |
Підтримується Інтерфейси: Ethernet/wi-fi |
Ощадбанк | BPOS1 | Протокол для роботи з терміналами Ingenico з налаштуваннями Ощадбанку. | 1) Ingenico desk/2600 2) Ingenico desk/3200 |
Підтримується Інтерфейси: Ethernet/wi-fi, USB, COM |
Наразі не підтримується |
Райффайзенбанк | POSAPI | Протокол Printec для роботи з терміналами. Може використовуватись для різних моделей терміналів, та банків. | 1) Verifone V200t 2) Verifone VX520 3) Castles Vega 3000 |
Підтримується Інтерфейси: Ethernet/wi-fi, USB, COM |
Підтримується Інтерфейси: Ethernet/wi-fi, USB, COM |
Укрсиббанк | BPOS1 | Протокол для роботи з терміналами Ingenico з налаштуваннями Укрсиббанку. | 1) Ingenico move/2500 |
Підтримується Інтерфейси: Ethernet/wi-fi, USB, COM |
Наразі не підтримується |
Банк Восток | BPOS1 | Протокол для роботи з терміналами Ingenico з налаштуваннями Банку Восток. | 1) Ingenico desk/2600 |
Підтримується Інтерфейси: Ethernet/wi-fi, USB, COM |
Наразі не підтримується |
Банк ПУМБ | POSAPI | Протокол Printec для роботи з терміналами. Може використовуватись для різних моделей терміналів, та банків. | 1) Verifone V200t |
Підтримується Інтерфейси: Ethernet/wi-fi, USB, COM |
Підтримується Інтерфейси: Ethernet/wi-fi, USB, COM |
А-Банк | BPOS1 | Протокол для роботи з терміналами ingenico з налаштуваннями А-Банку. | 1) Ingenico move/2500 | Підтримується Інтерфейси: Ethernet/wi-fi, USB, COM |
Наразі не підтримується |
Банк Південний | BPOS1 | Протокол для роботи з терміналами ingenico з налаштуваннями Банку Південний. | 1) Ingenico ICT220 | Підтримується Інтерфейси: Ethernet/wi-fi, USB, COM |
Наразі не підтримується |
А-Банк | A-BankJson | JSON протокол для роботи з терміналами А-Банку. | 1) Ingenico Axium DX8000 | Підтримується Інтерфейси: Ethernet/wi-fi |
Підтримується Інтерфейси: Ethernet/wi-fi |
Банк Південний | BPOS Light | Протокол для легкої інтеграції з терміналами компанії Ingenico. | 1) Ingenico desk/2600 | Підтримується Інтерфейси: Ethernet/wi-fi, USB, COM |
Підтримується Інтерфейси: Ethernet/wi-fi |
Укрсиббанк | BPOS Light | Протокол для легкої інтеграції з терміналами компанії Ingenico. | 1) Ingenico desk/2600 | Підтримується Інтерфейси: Ethernet/wi-fi, USB, COM |
Підтримується Інтерфейси: Ethernet/wi-fi |
Банк Восток | BPOS Light | Протокол для легкої інтеграції з терміналами компанії Ingenico. | 1) Ingenico desk/2600 | Підтримується Інтерфейси: Ethernet/wi-fi, USB, COM |
Підтримується Інтерфейси: Ethernet/wi-fi |
Таскомбанк | SimPays ККМ | Протокол інтеграції з терміналами компанії TRANSACTION SYSTEMS. | 1) PAX Q80S | Підтримується Інтерфейси: USB, COM, TCP_Server |
Підтримується Інтерфейси: TCP_Server |
Sense Банк | BPOS1 | Протокол для роботи з терміналами ingenico з налаштуваннями Sense Банку. | 1) Ingenico Move/2500 | Підтримується Інтерфейси: Ethernet/wi-fi, USB, COM |
Наразі не підтримується |
Sense Банк | POSAPI | Протокол Printec для роботи з терміналами. Може використовуватись для різних моделей терміналів, та банків. | 1) Verifone VX520 |
Підтримується Інтерфейси: Ethernet/wi-fi, USB, COM |
Підтримується Інтерфейси: Ethernet/wi-fi, USB, COM |
Sense Банк | SimPays ККМ | Протокол інтеграції з терміналами компанії TRANSACTION SYSTEMS. | 1) PAX Q80S | Підтримується Інтерфейси: USB, COM, TCP_Server |
Підтримується Інтерфейси: TCP_Server |
Інший банк | SSI JSON | Протокол інтеграції з терміналами компанії SSI. Робота з терміналами в режимі 2в1 термінал + принтер чеків. Може використовуватить на різних моделях терміналів та з різними банківськими застосунками(навіть одночасно кілька банків на одному терміналі) якщо на терміналі налаштовано протокол SSI JSON. | 1) Verifone X990 | Підтримується Інтерфейси: Ethernet/wi-fi |
Підтримується Інтерфейси: Ethernet/wi-fi |
В даному розділі описано можливі способи підключення чекодруку в ДМ.
Для підключення потрібно обрати інтерфейс через який буде здійснюватись комунікація з принтером чеків:
Ethernet
- потрібно підключити принтер до мережі Ethernet кабелем. Встановлювати драйвер не потрібно. Для визначення IP адреси принтеру можна виконати "Selftest" Або перевірити на сторінці маршрутизатора.Одразу зауважимо що не всі моделі принтерів можуть відображатись в списку пристроїв на сторінці маршрутизатора.
USB
- потрібно підключити принтер до пристрою USB кабелем та встановити драйвер з сайту виробника. Для підключення потрібна назва принтеру в системі
Bluetooth
- потрібно підключити принтер по Bluetooth і ввести пароль при з'єднання(пароль зазвичай 1111 або 1234). Встановлювати драйвер не потрібно. Для підключення потрібна назва що відображається в списку підключених bluetooth пристроїв. 1
COM
- потрібно підключити принтер до пристрою за допомогою COM(RS232) кабелю та встановити драйвер з сайту виробника. Для підключення потрібна назва COM порту на якому підключено принтер і його швидкість.
Після вибору інтерфейсу та налаштування принтеру можна додати його в ДМ.
Для створення принтеру в додатку переходимо на сторінку підключення пристроїв.
За посиланням http://localhost:3939/dm/dashboard або перейти через інтерфейс ПРРО
Натискаємо ДОДАТИ ПРИСТРІЙ
В даному меню потрібно вказати назву для принтеру, назва має бути унікальна в межах всіх створених ПРРО і пристроїв в додатку, а також обрати тип пристрою "Принтер чеків" після чого натиснути "НАСТУПНИЙ КРОК"
Назву принетру наполегливо рекомендуємо вказувати без пробілів та спеціальних символів типу знаку табуляції(
\t
) чи лапок.
Ethernet
:
після IP адреси.USB
Для підключення принтера по USB на Linux якщо принтер лише один, назву можна не заповнювати або вказати шлях до принтеру
/dev/usb/lp0
. Кожен наступний підключений принтер по USB на linux буде мати номер на один більше, наприклад/dev/usb/lp1
Bluetooth
COM
COM1
58мм
- для принтерів з шириною стрічки 58мм;80мм
- для принтерів з шириною стрічки 80мм;Вручну
- у випадку якщо в принтера інший розмір стрічки або менше символів вміщується в один рядок.Вручну
потрібно вказати:Грошовий ящик(якщо такий підключений до принтеру) буде автоматично відкриватись у випадку:
ВІДКРИТИ ГРОШОВИЙ ЯЩИК
.ТЕСТ ДРУКУ
На принтері надрукується наступний чек:
Якщо тестовий друк було виконано і принтер надрукував інформацію, це означає що налаштування завершено і принтер готовий для роботи.
Для роботи з банківськими терміналами рекомендовано використовувати підключення по ethernet для більшої стабільності роботи.
Перед початком налаштування потрібно отримати попередньо налаштований термінал у банку.
На терміналі банком має бути:
Номер мерчанту, для подальшої роботи з терміналом, можна дізнатись в банку або через ДМ після підключення терміналу. Перевірити який номер мерчанту в терміналі можна за допомогою API або через вебінтерфейс налаштування терміналу натиснувши на кнопку "Отримати список мерчантів".
Зазвичай для терміналів Приватбанку, Ощадбанку та Укрсиббанку та Банку Восток нумерація мерчантів починається з 1, в той час для Райффайзенбанку це буде код 7 цифр встановлений банком.
2000
- Приватбанк, Ощадбанк, Банк Восток.5001
- Райффайзенбанк2100
- УкрсиббанкДля терміналів
Ощадбанку
таБанку Восток
стандартно встановлюється банком порт 2000, проте за рекомендаціями розробників протоколу для роботи з терміналами для стабільності в роботі бажано попросити у банку встановити порт2100
або інший відмінний від2000
.
Для підключення потрібно обрати інтерфейс через який буде здійснюватись комунікація з банківським терміналом:
Ethernet
- На терміналі банком має бути встановлено даний тип з'єднання банком. Додатково потрібно підключити термінал до мережі Ethernet кабелем. Встановлювати драйвери не потрібно.USB
- На терміналі банком має бути встановлено даний тип з'єднання банком. Додатково потрібно підключити термінал до пристрою USB кабелем та встановити драйвер який надасть банк (за виключенням терміналів Приватбанку, для них драйвер встановлювати не потрібно). Підключення по USB здійснюється через емуляцію в системі COM порту. Для підключення потрібна назва COM порту на якому підключено термінал.COM
- На терміналі банком має бути встановлено даний тип з'єднання банком. Для підключення через даний тип з'єднання потрібно уточнити чи надає банк можливість підключати термінали за допомогою COM
, так як наразі не всі банки надають таку можливість.МАС
термінала в налаштуваннях роутера. МАС
адрес вказано на самому терміналі.192.168.1.103
Зверніть увазу що роботу зі статичною IP адресою підтримують не всі моделі терміналів!
COM9
Для створення терміналу як пристрою в додатку переходимо на сторінку підключення пристроїв.
За посиланням http://localhost:3939/dm/dashboard або перейти через інтерфейс ПРРО
Натискаємо ДОДАТИ ПРИСТРІЙ
На першому кроці потрібно вказати, назву для терміналу (на власний розсуд, але назва терміналу має бути унікальна в розрізі всіх пристроїв включаючи ПРРО), обрати тип пристрою Банківський термінал
та натиснути НАСТУПНИЙ КРОК
Назву терміналу наполегливо рекомендуємо вказувати без пробілів та спеціальних символів типу знаку табуляції(
\t
) чи лапок.
Оберіть банк
вибираєте "Приватбанк"Оберіть інтерфейс підключення
потрібно обрати:COM
- у випадку підключення терміналу через USB або COM порт.Ethernet
- у випадку підключення терміналу через мережу.COM
, потрібно вказати назву COM порту в форматі COM№
де № - номер порту та швидкість. Стандартно швидкість на терміналах встановлюється максимальна(115200), але якщо банк встановив іншу, можна її вказати.Ethernet
потрібно вказати IP адресу терміналу. Порт буде встановлено за замовчуванням залежно від обраного банку, у випадку якщо порт терміналу відрізняється від стандартного його можна вказати через :
після IP адресу, наприклад 192.168.1.103:2100
СТВОРИТИ
Оберіть банк
вибираєте "Ощадбанк"Оберіть інтерфейс підключення
потрібно обрати:COM
- у випадку підключення терміналу через USB порт.Ethernet
- у випадку підключення терміналу через мережу.COM
, потрібно вказати назву COM порту в форматі COM№
де № - номер порту та швидкість. Стандартно швидкість на терміналах встановлюється максимальна(115200), але якщо банк встановив іншу, можна її вказати.Ethernet
потрібно вказати IP адресу терміналу. Порт буде встановлено за замовчуванням залежно від обраного банку, у випадку якщо порт терміналу відрізняється від стандартного його можна вказати через :
після IP адресу, наприклад 192.168.1.103:2100
СТВОРИТИ
Оберіть банк
вибираєте "Райффайзенбанк"Оберіть інтерфейс підключення
потрібно обрати:COM
- у випадку підключення терміналу через USB або COM порт.Ethernet
- у випадку підключення терміналу через мережу.COM
, потрібно вказати назву COM порту в форматі COM№
де № - номер порту та швидкість. Швидкість роботи COM порту можна залишити 115200.Ethernet
потрібно вказати IP адресу терміналу. Порт буде встановлено за замовчуванням залежно від обраного банку, у випадку якщо порт терміналу відрізняється від стандартного його можна вказати через :
після IP адресу, наприклад 192.168.1.103:2100
СТВОРИТИ
Оберіть банк
вибираєте "Укрсиббанк"Оберіть інтерфейс підключення
потрібно обрати:COM
- у випадку підключення терміналу через USB порт.Ethernet
- у випадку підключення терміналу через мережу.COM
, потрібно вказати назву COM порту в форматі COM№
де № - номер порту та швидкість. Стандартно швидкість на терміналах встановлюється максимальна(115200), але якщо банк встановив іншу, можна її вказати.Ethernet
потрібно вказати IP адресу терміналу. Порт буде встановлено за замовчуванням залежно від обраного банку, у випадку якщо порт терміналу відрізняється від стандартного його можна вказати через :
після IP адресу, наприклад 192.168.1.103:2100
СТВОРИТИ
Оберіть банк
вибираєте "Банк Восток"Оберіть інтерфейс підключення
потрібно обрати:COM
- у випадку підключення терміналу через USB порт.Ethernet
- у випадку підключення терміналу через мережу.COM
, потрібно вказати назву COM порту в форматі COM№
де № - номер порту та швидкість. Стандартно швидкість на терміналах встановлюється максимальна(115200), але якщо банк встановив іншу, можна її вказати.Ethernet
потрібно вказати IP адресу терміналу. Порт буде встановлено за замовчуванням залежно від обраного банку, у випадку якщо порт терміналу відрізняється від стандартного його можна вказати через :
після IP адресу, наприклад 192.168.1.103:2100
СТВОРИТИ
ПЕРЕВІРИТИ ЗВ'ЯЗОК З ТЕРМІНАЛОМ
. Ця команда не потребує додаткових дій на терміналі.ТЕСТ ЗВ'ЯЗКУ З БАНКОМ
в такому разі якщо на терміналі кілька мерчантів потрібно буде на екрані обрати по якому виконати перевірку зв'язку і натиснути зелену кнопку для підтвердження.Основна різниця:
-ПЕРЕВІРИТИ ЗВ'ЯЗОК З ТЕРМІНАЛОМ
успішне виконання означає що є зв'язок з терміналом;
-ТЕСТ ЗВ'ЯЗКУ З БАНКОМ
успішне виконання означає що є зв'язок з терміналом, а також з боку терміналу, є зв'язок з банком;
Зв'язок з терміналом встановлено
або
Тест зв'язку з банком успішний
Якщо перевірка зв'язку виконана успішно - налаштування завершено і термінал готовий до роботи.
В даному розділі описано можливі помилки при налаштування та роботі з терміналами та способи їх вирішення.
Помилка підключення по ip адресу та порту або помилка отримання відповіді від терміналу:
Ощадбанк
, Укрсиббанк
, Райффайзенбанк
, Банк Восток
Неможливо встановити з'єднання з терміналом по інтерфейсу Ethernet (192.168.1.103)
В дужках буде ip адреса яка виставлена в налаштуваннях терміналу в ДМ.
Рішення
: При отриманні даної помилки потрібно перевірити коректність введення IP адреси, у випадку якщо адреса коректна, але помилка повторюється - звернутись в банк для уточнення деталей.
Приватбанк
Помилка при з'єднанні за вказаною адресою: 192.168.1.103
Буде ip адреса яка виставлена в налаштуваннях терміналу в ДМ.
Рішення
: При отриманні даної помилки потрібно перевірити коректність введення IP адреси, для android терміналів PAX A930
має бути запущено Касове суміщення
та обрано тип підключення WI-FI
або LAN
. Скоріше за все адрес або порт вказано некоректно.
Якщо все перевірено, але помилка повторюється, за деталями та вирішенням помилки рекомендовано звернутись в Приватбанк.
Таймаут при перевірці зв'язку з терміналом
Рішення
: При отриманні даної помилки потрібно перевірити щоб на терміналі відображалось не меню а саме головний екран і щоб термінал не виконував інших оплат/запитів, для android терміналів PAX A930
має бути запущено Касове суміщення
та обрано тип підключення WI-FI
або LAN
.
Якщо все перевірено, але помилка повторюється, за деталями та вирішенням помилки рекомендовано звернутись в Приватбанк.
Некоректно вказано COM порт або порт відсутній в системі:
Ощадбанк
, Укрсиббанк
, Райффайзенбанк
, Банк Восток
Неможливо встановити з'єднання з терміналом по інтерфейсу COM (COM4)
В дужках буде назва COM порту яка виставлена в налаштуваннях терміналу в ДМ.
Рішення
: При отриманні даної помилки потрібно перевірити коректність введення COM порту, у випадку номер порту вказано коректно, але помилка повторюється - звернутись в банк для уточнення деталей.
Приватбанк
Неможливо відкрити СОМ порт. Порт відсутній в системі або зайнятий.
Рішення
: При отриманні даної помилки потрібно перевірити коректність введення COM порту та перевірити що закрито всі програми що можуть використовувати порт на якому працює термінал (наприклад емулятор каси від Приватбанку). для android терміналів PAX A930
має бути запущено Касове суміщення
та обрано тип підключення USB
. Також по USB може працювати лише мобільний термінал. Стаціонарний роботу по USB
не підтримує.
Якщо все перевірено, але помилка повторюється, за деталями та вирішенням помилки рекомендовано звернутись в Приватбанк.
Таймаут при перевірці зв'язку з терміналом
Рішення
: При отриманні даної помилки потрібно перевірити щоб на терміналі відображалось не меню а саме головний екран і щоб термінал не виконував інших оплат/запитів, для android терміналів PAX A930
має бути запущено Касове суміщення
та обрано тип підключення USB
. Також по USB може працювати лише мобільний термінал. Стаціонарний роботу по USB
не підтримує.
Якщо все перевірено, але помилка повторюється, за деталями та вирішенням помилки рекомендовано звернутись в Приватбанк.
Опис всіх можливих помилок можна знайти за посиланням: