<< Click to Display Table of Contents >> Navigation:  Дополнительные функции > Интеграция с банковским терминалом > Инструкции по подключению банковских терминалов > SSI_JSON

Инструкция по подключению POS-терминалов Verifone X990 по протоколу SSI JSON

Технология подключения банковского терминала по протоколу SSI_JSON используется для подключения терминалов типа Verifone X990. Для подключения терминала по данному протоколу требуется, чтобы со стороны поставщика терминала был установлен режим интеграции по JSON. Инструкция представлена на примере подключения тестового терминала от компании Servus System Integration с установленным платежным приложением ПУМБ.

Настройка совмещения на терминале

Для настройки совмещения терминала с Торгсофт на терминале должно быть установлено соответствующее платежное приложение и терминал должен быть подключен к интернету (для соединения с хостом и для возможности обновления ПО техподдержкой банка).

Рисунок 1 - Главный экран терминала

 

Рисунок 1, поз. 1 - приложение для настройки параметров подключения и администрирования терминала. С его помощью настраивается подключение к интернету и другие параметры, не имеющие отношения к интеграции с Торгсофт.

Рисунок 1, поз. 2 -  платежное приложение, в данном случае банка ПУМБ, которое можно запустить самому для выполнения операций с терминалом в ручном режиме, или же оно будет запускаться в фоновом режиме при получении команд от Торгсофт.

Приложение для настройки параметров подключения (рисунок 1, поз. 2) нужно для настройки подключения терминала по 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 - Терминал в диспетчере устройств (мобильный вариант)

 

Если терминал в стационарном исполнении, то подключение по СОМ/USB выполняется с помощью специального кабеля USB-RS232 и соответствующего переходника COM-USB. Кабель предоставляется поставщиком терминала и подключается к разъему RS-232 на терминале (рисунок 7).

Рисунок 7 - Общий вид и подключение кабеля USB-RS232

 

Драйвер для переходника устанавливается автоматически или при необходимости может быть запрошен у поставщика. В этом варианте терминал в диспетчере устройств будет выглядеть так, как представлено на рисунке 8.

Рисунок 8 - Терминал в диспетчере устройств (стационарный вариант)

 

Разработчик протокола указывает, что: «скорость порта может быть настроена индивидуально, например на 115200, но клиент должен перед настройкой интеграции указать, что интеграция будет по СОМ-порту и какой именно терминал использует для этого: мобильный или стационарный. После этого будет настроен профиль на желаемую скорость порта, но по умолчанию скорость порта всегда 9600».

Подключение терминала по Ethernet также имеет свои особенности. Терминал может работать по протоколу HTTP или непосредственно по TCP/IP. При подключении это определяется только номером порта, который указывается в настройках совмещения в Торгсофт. Для варианта HTTP это 3001, для варианта TCP/IP — 3000. Сам разработчик это формулирует следующим образом:

«Підключення по фізичному протоколу TCP/IP до POS-терміналу виконується адресацією запитів на IP адресу POS-термінала (ххх.ххх.ххх.ххх), порт підключення 3000 за замовчуванням. Також Підключення по протоколу HTTP виконується адресацією запитів , на IP адресу POS-термінала (ххх.ххх.ххх.ххх), порт підключення 3001 за замовчуванням (+1 від номеру порту TCP/IP підключення). Порт підключення до інтеграційного сервісу за необхідністю може бути змінений шляхом звернення до вашої фінансової організації, або до сервісної організації. Якщо на POS-терміналі присутні декілька платіжних додатків різних фінансових організацій, потрібно налаштовувати кожний платіжний додаток на свій індивідуальний порт»

Номера портов в настройках Торгсофт не являются константами и могут быть изменены, если есть такая необходимость. Для проверки подключения терминала по протоколу HHTP и базовых функций разработчик предоставляет эмулятор в виде WEB-интерфейса SSI_JSON_TEST.html (рисунок 9).

Рисунок 9 - общий вид WEB-интерфейса тестового эмулятора

 

Подключение терминала в Торгсофт

Рисунок 11 - Форма настройки банковского терминала (версия программы 2022.4.13)

 

Таймаут в контексте данного протокола это время, в течение которого Торгсофт будет ожидать ответ от терминала. В самом терминале может быть установлен свой таймаут и не один. Речь может идти о таймауте ожидания платежного средства (время в течении которого терминал будет ожидать приложения, проведения карты), время ожидания ПИН-кода и т. п. Исходя из этого следует устанавливать величину таймаута в Торгсофт. Например, если терминал настроен на 60 сек ожидания карты, то с помощью этого параметра можно «сократить» это время, например, до 30 сек.

Рисунок 12 - Форма настройки мерчанта банковcкого терминала (версия программы 2022.4.13)

 

Тип операции доступен только один - Оплата_Возврат. Мерчант следует указывать обязательно. Список мерчантов на терминале можно получить с помощью действия Информация по терминалу в списке терминалов. Результат возвращается в следующем виде:

Рисунок 13 - Информация по терминалу

 

Рисунок 14 - Дополнительные операции, доступные для настройки

 

Важно! Для данного протокола в справочнике Валюта должен быть указан международный код валюты, с которой выполняется операция на банковском терминале.

Рисунок 15 - Форма настройки кода валюты (версия программы 2022.4.13)