<< 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

Іноді при такому типі з'єднання термінал підключається, веб-інтерфейс запускається, але ніякі команди на термінал не надсилаються — термінал не реагує на них. У такому випадку рекомендується налаштувати запуск WebSocket сервера з правами адміністратора. Для цього слід у папці, в якій знаходиться виконуваний файл genericDriverJsonETH.exe:

•створити bat-файл наступного змісту:

pushd %~dp0

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

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

•створити ярлик для цього bat-файлу

•налаштувати ярлик на запуск з правами адміністратора і надалі запускати WebSocket-сервер цим ярликом (Мал. 15).

Мал. 15