Перейти к основному контенту

RkPayQR - Установка клиента

Перед установкой модуля интеграции убедитесь, что выполнены минимальные системные требования, а также получены все необходимые данные от банка

Дистрибутив на установку клиентской части можно загрузить по ссылке.

Установка клиента RkPayQR

Установка через инсталлятор

Запустить RkPayQrSetup выбранной версии:

image-1659954419667.png

Выбрать язык установки:

image-1659954490068.png

Выбрать каталог установки. Рекомендуется устанавливать в каталог с экземпляром RK7.

image-1659954604220.png

По умолчанию выбирать конфигурацию Main.json.

image-1659954648795.png

Подтвердить установку.

image-1659954674832.png

Настройка конфигурационного файла appsettings.json

{
  "HttpPort": 6800,
  "HideFormOnStart": true,
  "Left": 200,
  "Top": 500,
  "AutoStart": true,
  "QrLeft": 0,
  "QrTop": 0,
  "QrWidth": 768,
  "QrHeight": 1024,
  "QrMonitor": 1,
  "ShowQr" : true,
  "HideFormOnStart": false,
  
  "ServerUrl": "https://rkpayqr.ucs-service.ru/",
  "ReserveServerUrl": "https://rkpayqr.ucs-service.com/",
  "ServerTimeoutSecs": 30,
  "CheckPaymentFrequencySecs": 5,
  "PaymentWaitingSecs": 30,
  "Bank": "all",
  "BankSettings": {
  },
  
  "OrderCanceledErrorText":"",
  "CloseCheckFormSeconds": 20,
  "CloseCheckFormText": "Ваш электронный чек",
  "EQFormText": "Номер электронной очереди",
  "QrBottomText": "Наведите камеру телефона на QR код",
  "EQBottomText": "Отсканируйте код приложением ФНС\n\n\"Проверка чека\" чтобы его получить",
  
  "AutoPayment": {
    "IsEnabled": true,
    "XmlInterface": {
      "Ip": "127.0.0.1",
      "Port": 9200,
      "Login": "RkPayQR",
      "Password": "RkPayQR",
      "PayCurrencyIdent": 1001747,
      "PayEmployeeIdent": 1000046,
      "PayStationIdent": 15003,
      "MaxPayTimeoutSecs": 300,
      "RetryCount": 3,
      "RetryPauseSecs": 10,
      "CashStationInterface": {
        "Ip": "127.0.0.1",
        "Port": 9200
      }
    }
  }
}
Параметр Значение Описание
HttpPort
Основной порт модуля интеграции. Изменять не рекомендуется.
HideFormOnStart
Сворачивает окно программы при запуске (аналогично команде start /MIN RkPayQR.exe).
Left
Отступ слева для окна авторизации QR в пикселях.
Top
Отступ сверху для окна авторизации QR в пикселях.
AutoStart
Автозапуск сервера QR при запуске приложения.
QrLeft
Отступ слева для вывода QR-кода на экран в пикселях.
QrTop
Отступ сверху для вывода QR-кода на экран в пикселях.
QrWidth
Размер экрана под QR-код в пикселях (длина).
QrHeight
Размер экрана под QR-код в пикселях (высота не менее 600px).
QrMonitor
Номер монитора.
ShowQr
Отображать форму с QR-кодом на оплату.
ServerUrl
Адрес сервера RkPayQR, расположенного в UCS Service.
ReserveServerUrl
Адрес резервного сервера RkPayQR, расположенного в UCS Service.
ServerTimeoutSecs
Время ожидания ответа от сервера (в секундах). Должен быть больше чем PaymentWaitingSecs.
CheckPaymentFrequencySecs
Частота запросов к серверу на проверку оплаты. Ставить не менее 3 секунд.
PaymentWaitingSecs
Время ожидания оплаты при проверке через валюту в r_keeper_7, значение в секундах.
Bank
Указание на банк, с которым работает RkPayQR (sber, vtb, alpha, Raif).
OrderCanceledErrorText
Произвольный текст, который выводится при ошибке банка во время ожидания оплаты (быстрый чек).
CloseCheckFormSeconds
Таймаут отображения QR-кода фискального чека.
CloseCheckFormText
Надпись вверху второго экрана при отображении фискального чека.
EQFormText
Надпись над номером ЭО второго экрана при отображении фискального чека. Если указать пустым, то номер электронной очереди не выводится.
QrBottomText
Надпись внизу второго экрана при отображении фискального чека.
EQBottomText
Надпись под номером ЭО второго экрана при отображении фискального чека.
AutoPayment (раздел) Раздел для автооплаты, для совместимости со старыми версиями.
IsEnabled
Включение автооплаты.
XmlInterface (подраздел)
Ip
ip-адрес XML HTTP.
Port
Порт XML HTTP.
Login
Пользователь r_keeper_7 с правами HTTP.
Password
Пароль пользователя r_keeper_7 с правами HTTP.
PayCurrencyIdent
Идентификатор валюты для автоматической оплаты заказа после оплаты QR.
PayEmployeeIdent
Идентификатор сотрудника, от имени которого будет закрыт заказ после оплаты QR.
PayStationIdent
Идентификатор кассовой станции, от которой будет закрыт заказ после оплаты QR.
MaxPayTimeoutSecs
Количество секунд ожидания оплаты QR-кода при автооплате.
RetryCount
Количество повторных попыток автоматического закрытия чека через XML интерфейс.
RetryPauseSecs
Интервал между попытками автоматического закрытия чека через XML интерфейс в секундах.
CashStationInterface

Ip
ip-адрес XML HTTP.
Port
Порт XML HTTP.
ClientGuid
Идентификатор клиента на сервере.

Параметры RetryCount и RetryPauseSecs используются для того, чтобы при возникновении проблем с ФР (кончилась бумага, выключен и т.п.) проинформировать персонал об ошибке и дать время на ее исправление. Каждая неудачна попытка автоматического закрытия сопровождается отправкой сообщения на кассу и в телеграмм-бот (если используется). Для корректной работы этих параметров требуется версия R-Keeper 7.7.0.212 и подключенный к кассе один ФР.

Заполнение в старых версиях

Альфа банк:

"TermNo": "xxxx"

Сбербанк V1:

"IdQr": "*****"

Сбербанк V3:

 "IdQr": "***",    
 "IdQrSbp": "****",    
 "Tid": "***"

С версии 1.0.3.5хх конфигурация банка устанавливается автоматически. Секции "Bank" и "BankSettings" не заполняются.

Запуск клиента

В режиме фастфуд с выводом QR-кода на второй экран, кассовый сервер и doscash.exe должны быть на одном ПК со RkPayQR. В остальных случаях корректная работа не гарантируется!

  • Добавить ярлык RkPayQR.exe в автозагрузку
  • Запустить RkPayQR.exe

В общих настройках r_keeper_7 в свойствах драйвера HTTPs auth terminal укажите ConnectTimeout с таким же количеством секунд, как у параметра "PaymentWaitingSecs"

Пример запущенного экземпляра приложения:

image-1649060475251.png