Основная информация

Данная конфигурация и технология использования в частности, задействована банком ВТБ 24.

Примечание: для дополнительной информации, рекоммендуется ознакомиться - http://support.ucs.ru/ru/node/5456

Схема взаимодествия программных модулей

 Касса 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 заберет, обратится к пинпаду, а пинпад к серверу авторизации (должен иметь выход в интернет). Провести транзакцию на пинпаде. Получить ответ на кассе и распечатать необходимое количество слипов.