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

Инструкция по подключению POS-терминалов ПриватБанка по протоколу WebSoket/JSON

Технология подключения банковского терминала по протоколу WebSoket/JSON используется для подключения терминалов PAX и Verifon, но также можно работать и с терминалами Ingenico.

Для подключение терминала по данному протоколу требуется, чтобы на компьютере (локальном, к которому подключен терминал, либо на сервере) был запущен WebSoket сервер. В случае с терминалами от ПриватБанка это файл genericDriverJsonXXX.exe (или POSsvc.exe — устаревшая версия), предоставляемый банком. В зависимости от типа подключения (COM/USB или Ethernet) используются разные версии файлов, если речь идет об POSsvc.exe, или разные файлы в случае genericDriverJson: для совмещения по Ethernet - genericDriverJsonETH.exe, для совмещения по COM/USB - genericDriverJsonUSB.exe . При работе по типу подключения Ethernet файл запускается с параметром командной строки:

"genericDriverJsonETH.exe -ip XXX.XXX.XXX.XXX",

где XXX.XXX.XXX.XXX — IP адрес терминала.

Запуск данного файла рекомендуется поместить в автозагрузку. На момент запуска файла терминал должен быть включен.

Настройка подключения терминала

Для терминалов PAX настройки Ethernet вводятся непосредственно на терминале для чего следует выполнить следующие действия (на примере терминала PAX S800):

Зайти в настройки терминала: удерживая нажатой клавишу F1 (Рис. 1).

Рис. 1

 

Набрать комбинацию "0852". При этом на терминале отобразится следующая информация (Рис. 2).

Рис. 2

 

Нажать кнопку Menu. В открывшемся списке Инициализация терминала выбрать Заводское меню(ТМ) и нажать Ввод (зеленая кнопка) (Рис. 3).

Рис. 3

 

В открывшемся списке Main menu выбрать SystemConfig (Рис. 4) (нажать “1”) и ввести пароль 123456.

Рис. 4

 

В открывшемся списке SystemConfig выбрать Ethernet (нажать 3) (Рис. 5).

Рис. 5

 

Откроется список Ethernet, в котором, перейдя в пункт ShowConfig, можно просмотреть настройки подключения терминала (Рис. 6).

Рис. 6

 

Перейдя в пункт Static можно ввести требуемые (IPAddress, SubnetMask,Gateway) (Рис. 7).

Рис. 7

 

После установок настроек необходимо обратиться в техподдержку банка, сообщить о желаемом типе подключение (COM, Ethernet) и передать настройки. После получения подтверждения от банка выйти из меню и снять X-баланс на терминале (выбирается нажатием кнопок Вверх-Вниз (Рис. 8)).

Рис. 8

 

После этого настройки должны вступить в силу.

MAC-адрес терминала, при необходимости, можно просмотреть в Main Menu, перейдя в пункт Terminal Info.

 

Применение настроек для других типов терминалов:

•Verifone: Параметры подключения (IP, маска подсети, DNS, шлюз) передаются банку. После того, как банк внесет эти данные в свою БД (дополнительно следует сообщить банку тип совмещения — USB/COM или Ethernet) следует применить настройки на терминале:

1.Выбрать пункт меню Инициализация.

2.После завершения процесса инициализации выбрать интерфейс подключения к кассе, нажав крайнюю справа фиолетовую клавишу, ввести пароль 3771 (актуально для банкоматов ПриватБанка), ввести номер функции - 17, и сохранить значение (ETH) - ввести цифру 4.

Примечание: MAC-адрес терминала указан под его задней крышкой в виде: З10BT/HS A460112EE202И, где курсивом выделен собственно MAC-адрес.

•Ingenico — Параметры подключения передаются в банк и настраиваются на их стороне. Для применения настроек с помощью меню Загрузка параметров и перезагрузка по питанию.

 

Подключение по COM/USB

Подключение терминалов PAX по COM/USB выполняется с помощью специального кабеля, предоставляемого банком (обычный USB<->miniUSB для этой цели не подходит. Разъем miniUSB терминала является служебным и не предназначен для подключения терминала к ПК). Также следует установить драйвер переходник СОМ_USB для PAX.

Для терминалов типа Ingenico подключение по COM/USB выполняется с помощью обычного кабеля, аналогично тому, как это делается для протокола BPOS. Номер COM-порта определяется автоматически и его не надо нигде указывать.

Рис. 9

 

Проверка подключения терминала

После того, как настройки установлены и применены следует запустить WebSocket сервер (POSsvc.exe) и в браузере зайти по адресу http://localhost:3000/ (если сервер запущен на удаленном компьютере, то вместо localhost следует ввести его IP). Если все настроено корректно в браузере должно отобразится следующее (Рис. 10).

Рис. 10

 

С помощью данного эмулятора можно протестировать работу терминала (желательно требовать от представителя банка, подключающего терминал, демонстрации того, что терминал подключен запуском данного эмулятора).

 

Проверка подключения терминала с помощью утилиты BankTerminalTest

Выбирается соответствующий протокол, вводится IP хоста и порт. В отличие от терминалов по BPOS не реализована работа с сервисами и нет никаких дополнительных настроек в зависимости от типа подключения. Единственный момент, на который следует обратить внимание это номер мерчанта. Независимо от того, под какими номерами отображаются мерчанты, возвращаемые функцией POSGetInfo для терминалов PAX следует указывать 0.

Рис. 11

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

В каждом конкретном случае указывается IP компьютера, на котором запущен WebSoket сервер. Порт всегда 3000 (Рис. 12).

Рис. 12

 

В некоторых случаях (например, для терминалов PAX A930, оплата может производиться только на пустой мерчант. В таком случае поле Порядковый номер мерчанта следует оставить пустым) (Рис. 13).

Рис. 13

 

Особенности подключения терминалов типа Ingenico

По умолчанию для терминалов данного типа может быть установлен режим возврата с использованием сервиса. В таком случае при стандартных настройках (тип операции Оплата_Возврат) функция возврата может не работать (будет появляться ошибка). Для решения данной проблемы необходимо либо обратиться в банк и попросить настроить терминал на обычный возврат, либо создать отдельный мерчант для оплаты (тип операции Оплата с соответствующим номером или 0) и отдельный мерчант с типом операции Возврат. Номер мерчанта следует установить в соответствии с тем, который возвращает операция Информация по терминалу, обычно для возврата это 2 (если не будет работать, то можно попробовать 0 или 5). Также следует установить переключатель Использовать сервис (Рис. 14).

Рис. 14

 

Особенности подключения терминалов в варианте совмещения по Ethernet

Иногда при таком типе совмещения терминал подключается, web-интерфейс запускается, но никакие команды на терминал не отправляются — терминал никак на них не реагирует. В таком случае рекомендуется настроить запуск WebSocket сервера с правами администратора. Для этого следует в папке, в которой находится исполнимый файл genericDriverJsonETH.exe:

•создать bat-файл следующего содержания:

pushd %~dp0

start genericDriverJsonETH.exe -ip ХХХ.ХХХ.ХХХ.ХХХ

, где ХХХ.ХХХ.ХХХ.ХХХ — IP-адрес терминала

•создать ярлык для этого bat-файла

•настроить ярлык на запуск с правами администратора и в дальнейшем запускать WebSocket -сервер данным ярлыком (Рис. 15).

Рис. 15

 

Особенности подключения терминала Pax A930

Никаких особых отличий при настройке данного терминала от остальных нет. Следует обратить внимание на следующие моменты:

1.Мерчант для оплаты для данного терминала обычно устанавливается пустым. На момент написания этого текста ПО данного терминала не поддерживало оплату на несколько конкретных мерчантов. В случае, если на терминале заведено несколько мерчантов, то при оплате терминал должен предлагать выбор мерчанта для оплаты.

2.Настройка совмещения с кассой (Торгсофт или утилита для тестирования) выполняется в следующем порядке.

•на экране терминала "нажимается" иконка Кассовое совмещение (Рис. 16) и выбирается соответствующий тип совмещения: USB или WiFi (Рис. 17);

Рис. 16

Рис. 17

 

•запускается соответствующий исполняемый файл genericDriverJsonETH(USB).

Если все настроено корректно, то при удачном совмещении будет мигать зеленый кружочек (Рис. 18).

Рис. 18