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

 

Форма настройки мерчанта (операции) банковcкого терминала (Рис. 5).

Рис. 5

 

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

В случае необходимости выполнения операции закрытия финансового дня, данная операция может быть добавлена в список операций для банковского терминала. Это единственная операция для данного протокола, которая может быть выбрана (Рис. 6).

Рис. 6

 

Важно! В справочнике Валюта (Настройки - Валюта) должна быть определена национальная валюта и заполнен соответствующий ей цифровой код. Для валюты "Гривня" это 980 (Рис. 7).

Рис. 7