|
<< Click to Display Table of Contents >> BankCore (SmartOne) |
|
|
<< Click to Display Table of Contents >> BankCore (SmartOne) |
|
Інструкція з підключення POS-терміналів SmartOne за протоколом BankCore JSON
Технологія підключення банківського термінала за протоколом BankCore JSON використовується для підключення терміналів типу SmartOne.
Налаштування суміщення на терміналі
Для налаштування суміщення термінала з Торгсофт на терміналі має бути встановлений платіжний застосунок, а термінал має бути підключений до інтернету (для з’єднання з хостом і можливості оновлення ПЗ техпідтримкою банку).
Рисунок 1 — головний екран термінала
На рисунку 1, поз. 1 - платіжний застосунок, який можна запустити самостійно для виконання операцій із терміналом у ручному режимі, або ж він запускатиметься у фоновому режимі під час отримання команд від Торгсофт.
На рисунку 1, поз. 2 - застосунок для налаштування параметрів підключення та адміністрування термінала. З його допомогою налаштовується підключення до Wi-Fi та інші параметри, які не стосуються інтеграції з Торгсофт.
Застосунок для налаштування параметрів підключення потрібен для налаштування підключення термінала через Wi-Fi.
Рисунок 2 — Головне вікно налаштувань
Для налаштування підключення через Wi-Fi слід зайти в меню Мережа й Інтернет (рисунок 2). Вибрати та налаштувати відповідну мережу Wi-Fi і налаштувати підключення до неї.
Рисунок 3 — Налаштування підключення через Wi-Fi
Після налаштування з’єднання слід зайти в налаштування створеного підключення, де можна побачити IP-адресу, яку буде присвоєно терміналу, та його MAC-адресу (рекомендується налаштувати статичну IP-адресу для термінала на роутері, інакше IP-адреса може «плавати», що незручно).
Рисунок 4 — Деталі підключення
Підключення термінала
Підключення термінала можливе лише бездротове через Ethernet (HTTP). Термінал працює за протоколом HTTP (рисунок 5).
Рисунок 5 — Форма налаштування банківського термінала (2026.0.5)
Порт для підключення фіксований (8888), під час налаштування змінювати його не рекомендується.
Тайм-аут у контексті цього протоколу — це час, протягом якого Торгсофт очікуватиме відповідь від термінала. У самому терміналі встановлено тайм-аут 60 с, і ввести більше значення під час налаштування термінала в Торгсофт не можна.
Налаштування Друк чека на терміналі керує друком чеків на терміналі. Якщо воно вимкнене, термінал не буде друкувати або пропонувати надрукувати чек. Поведінка може відрізнятися залежно від операції : при увімкненому налаштуванні під час формування Z-звіту чек завжди друкується, а під час формування X-звіту — пропонується).
Тип операції доступний лише один — Оплата_Повернення (рисунок 6).
Рисунок 6 — Форма налаштування мерчанта банківського термінала (2026.0.5)
Мерчанта вказувати не обов’язково (якщо на терміналі налаштований один торговець), але наполегливо рекомендується. Список мерчантів на терміналі можна отримати за допомогою дії Інформація про термінал.
Для зазначення номера мерчанта потрібні два параметри: Terminal і Merchant (рисунок 6). Формат введення номера мерчанта: Terminal_Merchant. Можна ввести лише одну частину — Terminal або Merchant, але обов’язково залишити символ «_» (наприклад 4174_ , _3360). Якщо залишити поле порожнім, то під час виконання операції термінал визначатиме мерчанта за своїми внутрішніми алгоритмами, що у випадку, коли на терміналі налаштовано більше одного торговця, може призвести до некоректного виконання операції або неможливості її виконання.
Для терміналів з протоколом BankCore доступна дія Операції банківського терміналу 
.
По натисканню на кнопку відкривається однойменне вікно (рисунок 7), де можна сформувати список операцій, які можуть викликатися для даного терміналу з Торгсофт
Рисунок 7 - Операції банківського терміналу для BankCore (2026.0.5)
Важливо! В довіднику Валюта (Налаштування - Валюта) має бути визначена національна валюта та заповнений відповідний їй цифровий код. Для валюти "Гривня" це 980 (рисунок 8).
Рисунок 8 - Налаштування коду валюти (2022.0.5)