RkPayQR - Установка клиента
Перед установкой модуля интеграции убедитесь, что выполнены минимальные системные требования, а также получены все необходимые данные от банка
Дистрибутив на установку клиентской части можно загрузить по ссылке.
Установка клиента RkPayQR
Установка через инсталлятор
Запустить RkPayQrSetup выбранной версии:
Выбрать язык установки:
Выбрать каталог установки. Рекомендуется устанавливать в каталог с экземпляром RK7.
По умолчанию выбирать конфигурацию Main.json.
Подтвердить установку.
Настройка конфигурационного файла 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 | ||
| Left | ||
| Top | ||
| AutoStart | ||
| QrLeft | ||
| QrTop | ||
| QrWidth | ||
| QrHeight | ||
| QrMonitor | ||
| ShowQr | ||
| 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 интерфейс в секундах |
"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": -надпись под номером ЭО второго экрана при отображении фискального чека"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 интерфейс в секундах
Параметры RetryCount и RetryPauseSecs используются для того, чтобы при возникновении проблем с ФР (кончилась бумага, выключен и т.п.) проинформировать персонал об ошибке и дать время на ее исправление. Каждая неудачна попытка автоматического закрытия сопровождается отправкой сообщения на кассу и в телеграмм-бот (если используется). Для корректной работы этих параметров требуется версия R-Keeper 7.7.0.212 и подключенный к кассе один ФР.
"CashStationInterface":
"Ip": - ip-адрес XML HTTP
"Port": - порт XML HTTP
"ClientGuid": - идентификатор клиента на сервере
С версии 1.0.3.5хх конфигурация банка устанавливается автоматически. Секции "Bank" и "BankSettings" не заполняются
С версии 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"
Пример запущенного экземпляра приложения:
