Настройка связи кассы Rk6 с пинпадами банка "ВТБ 24" с использованием протокола Arcus NET Server
Основная информация
Данная конфигурация и технология использования в частности, задействована банком ВТБ 24.
Примечание: для дополнительной информации, рекоммендуется ознакомиться c Настройка связи с банковскими терминалами авторизации кредитных карт (пинпады)
Схема взаимодествия программных модулей
Касса RK6 DOS(ucs) ---> Промежуточный сервер ARBRIDGE Win32(ucs) ----> ---> ArcusNetServer Win32 (АРКОМ) -----> Пинпад (Ethernet)------>Сервер авторизации кр.карт.
Ответ по обратной цепочке.
Настройки на кассе - DOS-RKCLIENT 6.107 и выше
- В \RKCLIENT добавить соответсвующий драйвер SMPAUTH.DLL (можно взять с нашего фтп - ftp://.../r-keeper/versions/SMPAUTH/ARCUS2/DOS/) для взаимодействия кассы с ARBRIDGE.
- В \RKCLIENT\RKEEPER6.INI прописать параметры:
Smpauth_Server=ARBRIDGE_123 - NETBIOS-имя сервера Arbridge, который должен работать через rnbopen.dll Smpauth_KKM=1 - Номер кассы от 1 до 99, который будет передан серверу Arcus Smpauth_Log=2 - Уровень детализации лога: 0-не логировать, 1-верхний уровень, 2-все. PinPadSlips=2 - количество печатаемых слипов.
Настройки на кассе - Rk6Win 6.109.1 и выше
- В \Rk6Win добавить соответсвующий драйвер smpauth.dll и RtcpGate.dll (можно взять с нашего фтп - ftp://.../r-keeper/versions/SMPAUTH/ARCUS2/WIN/) для взаимодействия кассы с ARBRIDGE.
- В \Rk6Win\RKEEPER6.INI прописать параметры:
Smpauth_Server=192.168.0.1:3666 - IP и порт сервера Arbridge, который должен работать через Rtcp.dll. Smpauth_KKM=1 - Номер кассы от 1 до 99, который будет передан серверу Arcus Smpauth_Log=2 - Уровень детализации лога: 0-не логгировать, 1-верхний уровень, 2-все. PinPadSlips=2 - Количество печатаемых слипов.
Настройки в менеджерской Rk6 (E_Rest32.exe)
- Как обычно, должна быть заведена валюта в кредитных картах с кодом "PPAD", либо на кассе (RKEEPER6.INI) прописывается доп.параметр:
Smpauth_Code=8080 - где, указать коды валют через запятую которые должны оплачиваться через ПИНПАД (для дополнительной детализации в отчетах).
Настройка сервера Arbridge.exe
Сервер ARBRDGE - это "мост", связывающий кассы Rkeeper 6 c сервером авторизации ArcusNETServer. Кассы будут подключаться к ARBRIDGE.
ARBRIDGE будет общаться с сервером авторизации файлами через общий каталог. А сервер авторизации будет общаться с пинпадами (см.схему взаимодействия выше).
- Распаковать (взять можно с фтп - ftp://.../r-keeper/versions/SMPAUTH/ARCUS2/ARBRIDGE/) в отдельный каталог дистрибутив сервера ARBRIDGE (желательно на том же ПК где находится и ArcusNetServer).
Тип запуска, с ключами:
/install - установить как службу /uninstall - удалить из служб /desktop - запуск как обычного приложения
- Настроить конфигурационный файл Arbridge.INI:
[Options]
Log = 3 - уровень LOG-файлов
0 - старт стоп
1 - редкие события
2 - все запросы
3 - содержимое файлов обмена
ExchDir = D:\RK6\ARBRIDGE\EXCHANGE - Каталог для обмена файлами с Arcus NET Server (в настройках ArcusNetServer должен быть указан тот же ресурс)!!!
Timeout = 45 - столько секунд ждать ответ от Arcus NET Server
Encoding = 866 - кодировка получаемых от Arcus NET Server текстов
866 - кириллица DOS
1251 - кириллица Windows
65001 - utf-8
[LinkDLL]
1 = Rnbopen - для связи с кассами по NetBIOS (DOS-кассы)
2 = Rtcp - для связи с кассами по TCP (WIN-кассы)
[Rnbopen]
Server = ARBRIDGE - уникальное NetBIOS имя, к которому будут обращаться кассы
[Rtcp]
Port = 3666 - номер порта - от 1024, не конфликтующий с существующими,
например в диапазоне 3000-5000.Важно! Общий каталог обмена файлами НЕ ДОЛЖЕН находиться внутри рабочего каталога сервиса ArcusNetServer!!! Иначе возможны проблемы связанные с общим доступом к файлам этого каталога. Лучше всего создать каталог на рабочем (не системном) разделе в общедоступном месте, например, внутри каталога \ARBRIDGE.
Примечание: ARBRIDGE с кассой общается через NETBIOS, по-этому в настройках сетевого протокола TCP должен быть включен параметр "NETBIOS over TCP/IP". Так же, можно использовать для связи проткол - "NetBEUI protocol".
Если возникают проблемы связи при работе ARBRIDGE как сервиса - прописать зависимости от NetBIOS и TCP. Это можно сделать например, при помощи утилиты sc.exe идущей в составе ОС Windows. "Пуск" \ "Выполнить", пример строки запроса:
sc config D__RK6__ARBRIDGE_ARBRIDGE depend= TCPIP/NETBIOS
- где "D__RK6_ARBRIDGE_ARBRIDGE" - название установленной службы. Результат:
ArcusNetserver
- Устанавливается и настраивается на связь с пинпадами, которые подключены через ethernet в обычную ЛВС и имеют выход в интернет.
- А также, настраивается на общий (с ARBRIDGE) сетевой каталог, конф.файл services.xml:
... <fileService name="File transactions" folder="D:\RK6\ARBRIDGE\EXCHANGE\" lockDetectionTimout="2000" lockDetectionDelay ="500"> <fileTransactions parser="shoko-file" encoding="CP866" ...
Примечание: Установку и все настройки ArcusNetServer выполняют специалисты техподдержки самого банка-партнера предоставившего для работы ПО и пинпады.
Важно! для запуска данного сервера необходимо что бы на ПК была установлена поддержка Java не ниже v7.
ПИНПАД (Ingenico IPP 320 с питанием и ethernet-интерфейсом)
- Настраивается и проверяется на связь с ПО ArcusNetServer специалистами самого банка.
Проверка работы
Запустить ARBRIDGE, запустить ArcusNetServer, запустить кассу, убедиться что пинпад подключился к ArcusNetServer (на нем должно гореть сообщение типа - "Готов к работе", если отображается сообщение типа "Подключение к кассе", - значит связи нет).
При оплате на кассе выбрать валюту оплаты через пинпад, касса должна выполнить подключение к серверу ARBRIDGE (можно увидеть во вкладке "Clients"), тот в свою очередь сформирует и выложит в каталог обмена файлы для ArcusNetServer (ANS). ANS заберет, обратится к пинпаду, а пинпад к серверу авторизации (должен иметь выход в интернет). Провести транзакцию на пинпаде. Получить ответ на кассе и распечатать необходимое количество слипов.