Интеграция поддерживается начиная с версии r_keeper 7.07.00.222.

Для подключения Системы быстрых платежей (СБП):

  1. Закажите необходимые лицензии
  2. Обратитесь в службу поддержки вашего банка или получите данные для интеграции.
  3. Выполните настройки в менеджерской станции. В версии r_keeper 7.07.00.228 и выше настройки предустановлены.
  4. Настройте Farcards
  5. Настройте конфигуратор банка.

Лицензии и настройки в менеджерской станции описаны в отдельной статье.

Настройка farcards

  1. Скачайте архив для банка Русский стандарт https://files-rkcloud.ucs.ru/d/65231391cff842d49a1a/?p=/rk7/other/%D0%A1%D0%91%D0%9F&mode=list

  2. Распакуйте архив, извлеките последнюю версию папки с настройками и сам сервер farcards в одну папку и настройте файл farcards.ini:

    [FarServer]
Type = 1
DLL = SbpRusStandardFc.dll
Gate = 1
XMLCP=1251
 
 
[LinkDLL]
1 = pds_netk
 
[pds_netk]
NetServerName=SBP
ininame=netk.ini
DebugMessages=1
    CODE

    В строке NetServerName вместо SBP укажите имя вашего сервера, которое указано в настройках PDS интерфейса

  3. Убедитесь, что кассовый сервер работает. Запустите его, если он не активен

  4. Запустите Farcards как службу: создайте ярлык для farcards с параметром /install. Например, …FarCards_BRS\Farcards.exe /install. Запустите ярлык от имени администратора.

Важно!

Чтобы оплата проходила без ошибок, запускайте службу Farcads только при работающем кассовом сервере.

Настройка конфигуратора

Получите в банке электронные сертификаты.

После этого:

  1. Файл name.pem переименуйте в clientKey.pem
  2. Скопируйте privatekey.pem и переименуйте в selfSignedKey.pem
  3. Файлы privateKey.pem, clientKey.pem из пункта 1, selfSignedKey.pem из пункта 2) скопировать в папку HttpCerts, находящейся в папке farcards.

Из папки Farcards_BRS запустите RusStandardConfigurator.exe и выполните следующие действия:

  1. Заполните на вкладке Настройки поля в блоках Настройки, которые выдаются банком:
    1. Регистрационный номер
    2. Идентификатор торгово-сервисного предприятия (ТСП) в СБП
    3. Номер расчетного счета, открытого предприятием в банке.
  2. Укажите Настройки подключения к r_keeper 7:
    1. IP-адрес кассового сервера
    2. Порт для подключения к кассовому серверу
    3. Имя предустановленного пользователя из группы HTTP-user
    4. Пароль этого пользователя.
  3. Нажмите кнопку Тест соединения.
  4. Если настройки подключения выполнены правильно, то станет доступен для заполнения блок Дополнительные
    • Интерфейс Farcards — выберите предустановленный интерфейс. Чтобы выбрать, нажмите кнопку с тремя точками.
    • Валюта для оплаты — выберите предустановленную валюту СБП
    • Скидка — выберите предустановленную скидку
      • Если используется режим "С обслуживанием", заполните поле Причина внесения предоплаты. В режиме fastfood, заполнять поле не требуется
    • Кассир (код кассира) — укажите код кассира, который будет работать с СБП. Код кассира можно посмотреть в меню Персонал > Работники, в свойствах нужного кассира.
    • Станция для оплаты — выберите станцию, на которой будет приниматься оплата по СБП.
    • Код документа для печати qr-кода — в качестве кода используйте код группы Купоны, в которой находится используемый макет.
  5. После заполнения полей на вкладке Настройки перейдите на вкладку Лицензия
  6. На вкладке введите числовой Дилер ID и пароль дилера, у которого есть права на работу с объектом. Нажмите кнопку Проверить лицензию
  7. Если лицензии не обнаружены, система выдаст соответствующую ошибку.

    Если лицензия обнаружена, система сообщит ее данные.
  8. Нажмите кнопку Сохранить настройки в конфигураторе.

Если у вас есть несколько активных лицензий на продукт — применится лицензия с большим сроком действия.

При возникновении ошибок с токеном, при обновлении плагина СБП обратитесь на integrations@rkeeper.ru

Генерация статических QR-кодов

Статические QR-коды - это коды, которые не изменяются после генерации и могут быть нанесены на необновляемые носители, например, бумагу. При оплате кассир может выбрать статический QR-код из списка доступных, после чего клиент сможет произвести оплату по выбранному QR-коду.

Настройка MCR-алгоритмов

Создайте или отредактируйте MRC алгоритм:

  1. В менеджерской станции перейдите в меню Сервис > Обработка сигналов устройств > MRC алгоритмы
  2. Выберите алгоритм СБП. Если он не создан, создайте.
  3. В свойствах алгоритма в блоке Основное укажите:
    1. Тип алгоритма — Префикс
    2. Типы устройств — выберите необходимое. В примере: Клавиатура, Магнитная карта, Скрипт, Штрих код
    3. Укажите объект — Интерфейс СБП
    4. Префикс — назначьте префикс, например, QR.
  4. Сохраните изменения.

Генерация статических QR-кодов

После заполнения основных данных в конфигураторе и проверки лицензии необходимо создать статические QR-коды на вкладке "Статические QR-коды". Для этого нужно:

  1. Нажмите на кнопку Добавить новый код, выберите сгенерированный код в таблице
  2. Заполните поля Название, Связанный код карты. В поле Название нужно указать название QR-кода, которое будет отображаться на кассе после запроса доступных QR-кодов. В поле Связанный код карты нужно указать последовательность символов, которая будет использоваться для прямого выбора QR-кода на кассе (ввод кода с клавиатуры)

  3. Нажмите на кнопку рядом с полем Использовать на кассе. Выберите в открывшемся окне кассовую станцию, за которой будет закреплен данный QR-код

    Помимо кассовых станций в списке доступны опции Не использовать и На любой. При выборе опции Не использовать QR-код не будет отображаться и работать на кассе.
    При выборе опции На любой QR-код будет работать на всех кассах.

     Вариант На любой можно применять только в сценариях TableService. При попытке использовать такой QR-код в сценарии FastFood будут возникать ошибки.

  4. Поля TerminalId и Расчетный счет заполняются автоматически при добавлении: Расчетный счет копируется из соответствующего поля с вкладки Настройки. Поле terminalId заполняется на основе скрытой настройки terminalId, которая заполняется случайным значением при первом запуске конфигуратора. 
  5. Для заполнения полей Qr-код, QrcId, SourceId, TerminalId и Расчетный счет есть 2 варианта:
    1. Сформировать с использованием api, предоставляемым банком - для этого нужно нажать кнопку Запросить новый qr-код из банка, при этом все поля заполнятся автоматически - этот вариант подходит в случае, если статические коды не предоставлены в уже сформированном / распечатанном виде
    2. Заполнить вручную - этот вариант нужно использовать, если статические коды предоставлены в уже сформированном / распечатанном виде. Данные для ввода нужно уточнять у сотрудников банка, предоставивших qr-код
  6. После заполнения / генерации данных статического qr-кода нужно нажать кнопку Применить изменения
  7. После завершения создания и редактирования QR-кодов сохраните настройки, нажав на кнопку Сохранить настройки.

Готово. Оплата по системе быстрых платежей (СБП) для банка Русский Стандарт настроена.

Чтобы проверить настройки, пройдите путь заказа от создания до оплаты с помощью QR-кода.