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

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

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

Получение дистрибутива

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

ftp://ftp-anonim.ucs-service.ru:4000/rkpayqr/client/

Вход на FTP анонимный (необходимо выбрать в настройках подключения)

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

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

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

      image-1659954419667.png

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

      image-1659954490068.png

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

       

      image-1659954604220.png

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

      image-1659954648795.png

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

      image-1659954674832.png

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

    {
      "HttpPort": 6800,
      "Left": 200,
      "Top": 500,
      "AutoStart": true,
      "QrLeft": 0,
      "QrTop": 0,
      "QrWidth": 768,
      "QrHeight": 1024,
      "QrMonitor": 1,
      "ShowQr" : true,
      
      "ServerUrl": "https://rkpayqr.ucs-service.ru/",
      "ReserveServerUrl": "https://rkpayqr.ucs-service.ru/",
      "ServerTimeoutSecs": 30,
      "CheckPaymentFrequencySecs": 3,
      "PaymentWaitingSecs": 30,
      "Bank": "SberV3",
      "BankSettings": {
      },
      
      "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,
          "CashStationInterface": {
            "Ip": "127.0.0.1",
            "Port": 9200
          }
        }
      }
    }

    "HttpPort":  - основной порт модуля интеграции. Изменять не рекомендуется
    "Left": - отступ слева для окна авторизации QR в пикселях
    "Top": - отступ сверху для окна авторизации QR в пикселях
    "AutoStart": - автозапуск сервера QR при запуске приложения

    "QrLeft": - отступ слева для вывода QR-кода на экран в пикселях
    "QrTop": - отступ сверху для вывода QR-кода на экран в пикселях
    "QrWidth": - размер QR-кода на экран в пикселях
    "QrMonitor": - номер монитора
    "ShowQr": - отображать форму с QR-кодом на оплату

    "ServerUrl":  - адрес сервера RkPayQR, расположенного в UCS Service,
    "ReserveServerUrl": - адрес резервного сервера RkPayQR, расположенного в UCS Service
    "ServerTimeoutSecs":  - время ожидания ответа от сервера (в секундах). Должен быть больше чем "PaymentWaitingSecs"

    "CheckPaymentFrequencySecs": - частота запросов к серверу на проверку оплаты. Ставить не менее 3 секунд
    "PaymentWaitingSecs": - время ожидания оплаты при проверке через валюту в r_keeper_7, значение в секундах
    "Bank": - указание на банк, с которым работает RkPayQR (sber, vtb,alpha).

    "CloseCheckFormSeconds":  - таймаут отображения QR-кода фискального чека
    "CloseCheckFormText": - надпись вверху второго экрана при отображении фискального чека
    "EQFormText":  - надпись над номером ЭО второго экрана при отображении фискального чека. Если указать пустым, то номер электронной очереди не выводится.
    "QrBottomText":  - надпись внизу второго экрана при отображении фискального чека
    "EQBottomText": -надпись под номером ЭО второго экрана при отображении фискального чека

    "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-кода при автооплате

    "CashStationInterface":

    "Ip":  - ip-адрес XML HTTP
    "Port": - порт XML HTTP

    "ClientGuid":  - идентификатор клиента на сервере

    С версии 1.0.3.ххх конфигурацию клиента можно дополнить данными банка

    Для этого необходимо дополнить секцию "BankSettings"

    Альфа банк:

    "TermNo": "xxxx"

    Сбербанк V1:

    "IdQr": "*****"

    Сбербанк V3:

     "IdQr": "***",    
     "IdQrSbp": "****",    
     "Tid": "***"
    Запуск клиента:

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

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

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

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

     

    image-1649060475251.png