<< Click to Display Table of Contents >> Navigation:  Додаткові функції > Підключення банківського терміналу > Інструкції підключення банківських терміналів > PosApi (Verifon VX 520, РайффайзенБанкаАваль)

Інструкція по підключенню POS-терміналів РайффайзенБанкаАваль по протоколу PosApi

Технологія підключення банківського термінала по протоколу PosApi використовується для підключення терміналів Райффайзенбанка (на прикладі Verifon VX 520).

Для підключення термінала по даному протоколу необхідно, щоб на локальному комп'ютері (до якого підключений термінал) був встановлений відповідний драйвер, а на комп'ютері з Торгсофт має бути файл бібліотеки Posapi.dll. Драйвери і бібліотеки надаються банком.

Драйвер і бібліотека постачаються для 32-х і 64-х бітних систем. Важливо, щоб встановлюваний драйвер відповідав розрядності системи. Файл бібліотеки слід використовувати 32-х бітної версії.

Налаштування підключення термінала

Підключення термінала можливе як по COM/USB, так і по Ethernet (для терміналів Verifone Альфа-банку порт за замовчуванням 5001). При використанні підключення по COM/USB при установці драйвера за замовчуванням термінал підключається на порт COM9 (Мал. 1).

Мал. 1

 

Підключення термінала Verifone по COM/USB виконується за допомогою звичайного USB<->miniUSB кабелю.

Перевірка підключення термінала за допомогою утиліти BankTerminalTest

Перевірка термінала за допомогою цієї утиліти аналогічна перевірці у випадку з іншими протоколами. Вибирається відповідний протокол, вводиться номер COM-порту (або IP і порт). Для протоколу PosApi не вибирається параметр Швидкість COM-порту, але вказується Тайм-аут. Це час у секундах, протягом якого термінал буде чекати відповіді від користувача. Також доданий параметр Робочий каталог. Це каталог, в якому має бути розташований файл бібліотеки posapi.dll і в якому буде зберігатися файл логу.

Особливістю роботи термінала по даному протоколу є те, що при суміщенні термінала з ПК, термінал, можливо, не буде працювати в ручному режимі. Тобто всі основні команди на виконання операцій повинні генеруватися програмою. У зв'язку з цим була додана кнопка для виконання операції закриття поточного фінансового дня Z-Report.

Також цей протокол не передбачає вказівки яких-небудь номерів мерчантів для операцій, але дозволяє вказувати так званий Код профілю авторизації або Ідентифікатор термінала. Це, в певному роді, аналог мерчанта, але методу отримання списку цих кодів з програми немає, його може надати банк, якщо на терміналі зареєстровано кілька розрахункових рахунків. Код профілю авторизації являє собою набір літерно-цифрових символів виду P0006366 (приклад). Для тестування термінала (за допомогою утиліти), на якому зареєстровано кілька розрахункових рахунків, перед виконанням операцій на терміналі слід ввести код профілю авторизації в поле TerminalID, або створити текстовий файл TerminalIDList.txt в робочому каталозі, в якому будуть перераховані доступні коди профілів авторизації, і вибрати потрібний (Мал. 2).

Мал. 2

 

Список кодів профілів авторизації завантажується автоматично при виборі протоколу PosAPI або може бути завантажений вручну по кнопці Оновити список кодів авторизації. Також можна ввести код профілю авторизації вручну.

 

Мал. 3

 

В деяких випадках при перевірці зв'язку з терміналом в логу може з'являтися повідомлення виду Операція перервана ПОС терміналом. Зв'язок з хостом не встановлена. Це не завжди є помилкою і в разі появи такого повідомлення все одно варто перевірити роботу операцій Оплата і Повернення. Також може не пройти тестова оплата на суму в 1 копійку. В цій ситуації слід спробувати провести оплату на суму, еквівалентну 0.01$ або на 1 грн.

 

Підключення термінала Verifone Райффайзенбанка в Торгсофт

Форма налаштування банківського термінала (Мал. 4).

Мал. 4

 

Форма налаштування мерчанта (операції) банківського термінала (Мал. 5).

Мал. 5

 

У разі з протоколом PosApi замість порядкового номера мерчанта (коду операції) в відповідне поле вводиться ідентифікатор термінала (аналог мерчанта для BPOS), який може містити не тільки цифри, але й букви. Список ідентифікаторів термінала можна отримати в банку. Поле можна залишити порожнім, якщо на терміналі зареєстровано лише один мерчант. Тип операції доступний тільки один - Оплата_Повернення.

У разі необхідності виконання операції закриття фінансового дня, ця операція може бути додана в список операцій для банківського термінала. Це єдина операція для даного протоколу, яка може бути вибрана (Мал. 6).

Мал. 6

 

Важливо! У довіднику Валюта (Налаштування - Валюта) повинна бути визначена національна валюта і заповнений відповідний їй цифровий код. Для валюти "Гривня" це 980 (Мал. 7).

Мал. 7