|
<< Click to Display Table of Contents >> SSI_JSON |
  
|
|
<< Click to Display Table of Contents >> SSI_JSON |
|
Інструкція з підключення POS-терміналів Verifone X990 за протоколом SSI JSON
Технологія підключення банківського термінала за протоколом SSI_JSON використовується для підключення терміналів типу Verifone X990. Для підключення термінала за цим протоколом необхідно, щоб з боку постачальника термінала був встановлений режим інтеграції за JSON. Інструкцію наведено на прикладі підключення тестового термінала від компанії Servus System Integration з установленим платіжним застосунком ПУМБ.
Налаштування суміщення на терміналі
Для налаштування суміщення термінала з Торгсофт на терміналі має бути встановлений відповідний платіжний застосунок, а сам термінал повинен бути підключений до інтернету (для з’єднання з хостом та для можливості оновлення ПЗ службою підтримки банку).
Рисунок 1 — Головний екран термінала
Рисунок 1, поз. 1 — застосунок для налаштування параметрів підключення та адміністрування термінала. За його допомогою налаштовується підключення до інтернету та інші параметри, що не стосуються інтеграції з Торгсофт.
Рисунок 1, поз. 2 — платіжний застосунок (у даному випадку банку ПУМБ), який можна запускати вручну для виконання операцій з терміналом або який запускатиметься у фоновому режимі при отриманні команд від Торгсофт.
Застосунок для налаштування параметрів підключення (рисунок 1, поз. 1) потрібен для налаштування підключення термінала по Wi-Fi. Для інших типів інтеграції — по TCP/IP або COM — у ньому немає потреби.
Рисунок 2 — Головне вікно налаштувань
Для налаштування підключення по Wi-Fi слід перейти до меню «Wi-Fi мережа».
Рисунок 3 — Налаштування підключення по Wi-Fi
Після налаштування з’єднання необхідно перейти до налаштувань створеного підключення, де можна побачити IP-адресу, що буде присвоєна терміналу, та його MAC-адресу (рекомендується налаштовувати статичний IP для термінала на роутері, інакше IP-адреса може змінюватися, що є незручним).
Рисунок 4 — Деталі підключення
Підключення термінала
Підключення термінала можливе як по COM/USB, так і по Ethernet (TCP/IP або HTTP). Кожен із типів підключення має свої особливості.
Підключення по COM/USB може відрізнятися залежно від типу термінала. Якщо це мобільний варіант, для підключення використовується стандартний кабель USB-Type-C, який також застосовується для заряджання пристрою. Цей варіант потребує встановлення відповідного драйвера для термінала, який можна знайти на офіційному сайті компанії Servus System Integration.
Рисунок 5 — Драйвер на офіційному сайті компанії SSI
У цьому варіанті після встановлення драйвера термінал має відобразитися в диспетчері пристроїв приблизно так:
Рисунок 6 — Термінал у диспетчері пристроїв (мобільний варіант)
Якщо термінал у стаціонарному виконанні, підключення по COM/USB здійснюється за допомогою спеціального кабелю USB-RS232 та відповідного перехідника COM-USB. Кабель надається постачальником термінала та підключається до роз’єму RS-232 на терміналі (рисунок 7).
Рисунок 7 — Загальний вигляд та підключення кабелю USB-RS232
Драйвер для перехідника встановлюється автоматично або, за необхідності, може бути запитаний у постачальника. У цьому варіанті термінал у диспетчері пристроїв виглядатиме так, як показано на рисунку 8.
Рисунок 8 — Термінал у диспетчері пристроїв (стаціонарний варіант)
Розробник протоколу зазначає: «швидкість порту може бути налаштована індивідуально, наприклад 115200, але клієнт перед налаштуванням інтеграції має вказати, що інтеграція буде по COM-порту, і який саме термінал використовується: мобільний чи стаціонарний. Після цього буде налаштовано профіль на потрібну швидкість порту, але за замовчуванням швидкість порту завжди 9600».
Підключення термінала по Ethernet також має свої особливості. Термінал може працювати за протоколом HTTP або безпосередньо по TCP/IP. Під час підключення це визначається лише номером порту, який зазначається в налаштуваннях суміщення в Торгсофт. Для варіанту HTTP це порт 3001, для варіанту TCP/IP — 3000.
«Підключення за фізичним протоколом TCP/IP до POS-термінала виконується шляхом адресації запитів на IP-адресу POS-термінала (xxx.xxx.xxx.xxx), порт підключення — 3000 за замовчуванням. Підключення за протоколом HTTP виконується шляхом адресації запитів на IP-адресу POS-термінала, порт підключення — 3001 за замовчуванням (+1 до номера порту TCP/IP). Порт підключення до інтеграційного сервісу за потреби може бути змінений шляхом звернення до фінансової або сервісної організації. Якщо на POS-терміналі встановлено декілька платіжних застосунків різних фінансових організацій, необхідно налаштовувати кожен платіжний застосунок на свій індивідуальний порт».
Номери портів у налаштуваннях Торгсофт не є константами та можуть бути змінені за потреби. Для перевірки підключення термінала за протоколом HTTP і базових функцій розробник надає емулятор у вигляді WEB-інтерфейсу SSI_JSON_TEST.html (рисунок 9).
Рисунок 9 — Загальний вигляд WEB-інтерфейсу тестового емулятора
Підключення термінала в Торгсофт
Рисунок 11 — Форма налаштування банківського термінала (версія програми 2022.4.13)
Таймаут у контексті цього протоколу — це час, протягом якого Торгсофт очікує відповідь від термінала. На самому терміналі може бути встановлено кілька таймаутів: очікування платіжного засобу (час очікування карти), очікування введення ПІН-коду тощо. Відповідно до цього слід налаштовувати значення таймауту в Торгсофт.
Рисунок 12 — Форма налаштування мерчанта банківського термінала (версія програми 2022.4.13)
Тип операції доступний лише один — Оплата_Повернення. Мерчант необхідно вказувати обов’язково. Список мерчантів на терміналі можна отримати за допомогою дії Інформація по терміналу у списку терміналів.
Рисунок 13 — Інформація по терміналу
Рисунок 14 — Додаткові операції, доступні для налаштування (версія програми 2022.4.13)
Важливо! Для цього протоколу в довіднику «Валюта» має бути вказаний міжнародний код валюти, з якою виконується операція на банківському терміналі.
Рисунок 15 — Форма налаштування коду валюти (версія програми 2022.4.13)