Технические требования
- двухъядерный процессор 2 ГГц;
- системная память 4 GiB RAM;
- 25 Гб свободного пространства на жестком диске.
В самом магазине сервер рекомендуется располагать как можно ближе к кассам, во избежание проблем со связью.
Дистрибутив
Актуальный образ выложен на FTP с последней версией УКМ 4.
Для стабильной работы потребуется последняя актуальная версия интегратора.
Актуальная версия
ukm_integrator 111 master, 77dcbba
Как проверить версию
/usr/local/qrpay/qrpayd --version
Инсталляция и обновление
Инсталлятор
При установке дистрибутива необходимо выбрать из списка доступных программ Universal integrator:
Если виртуальная машина после разворачивания получит сетевое имя, то данное имя надо прописать как 127.0.0.1 в /etc/hosts.
Примечание. Сетевое имя вручную менять нельзя! При этом сбрасываются настройки у RabbitMQ и ничего не работает! При установке Универсального интегратора конфигурационные файлы вспомогательного ПО Универсального интегратора привязываются к hostname, который будет присвоен при инсталляции, и последующая его смена не изменит этих настроек, что приведёт к неработоспособности Универсального интегратора.
В качестве базы данных используется MariaDB.
Обновление
Файл qrpay-update.sh необходимо поместить на сервер Универсального интегратора и дать ему права на исполнение:
chmod +x ./qrpay-update.sh
Затем нужно выполнить установку:
sudo systemctl stop qrpayd.service sudo ./qrpay-update.sh sudo systemctl start qrpayd.service
Логины/пароли
- Пользователь системы: qrpay/xxxxxx.
- Пользователь MariaDB: qrpay@localhost/xxxxxx.
- Пользователи RabbitMQ:
- admin/admin для администрирования;
- ukm/xxxxxx для доступа с кассы.
Веб от RabbitMQ
<ip>:15672
Rabbit логин/пароль: admin/admin
Настройки демона
В базе данных демона (qrpayd) есть таблица qrraiffd_configuration, из которой берутся следующие настройки:
- key – ключ авторизации;
- merchant_id – идентификатор зарегистрированного партнёра в СБП;
- operation_wait_timeout – время в секундах, в течение которого происходит опрос статуса операции (подтверждена оплата или возврат): сколько ждать, пока покупатель произведет оплату;
- qrpay_timeout – время (в мс) ожидания ответа от сервера банка: сетевой таймаут;
- qrpay_url – адрес отправки запросов (адрес в qrpay_url должен быть вида https://________raiffeisen.ru/api);
- request_period – период опроса статуса операции (в секундах): с какой частотой Универсальный интегратор запрашивает статус оплаты по QR-коду (прошла или нет);
- write_log_to_file – писать ли лог (0 – нет; 1 – да);
- op_type – тип операции:
- 2 – оплата;
- 3 – проверка статуса оплаты;
- 4 – возврат;
- 7 – отмена;
- op_result – результат операции:
- неизвестно – 1 (не получено никакого ответа);
- успешно – 0;
- ошибка – 4.
После прописывания в базе данных демона (qrraiffd), необходимо его перезапустить следующими командами:
sudo systemctl stop qrraiffd
sudo systemctl start qrraiffd
RabbitMQ перезапускать не надо.
Как снимать логи
Нужно подставить дату, за которую требуется получить лог. Полученный файл и есть лог, его и нужно прислать:
journalctl --since "2022-12-24 00:00:00" --until "2022-12-24 23:59:59" -a -u qrpayd.service > /home/ukmclient/qrpayd.log
Метки протоколирования
RabbitMQ – Работа с сервером RabbitMQ.
QR_PAYMENT – Средство оплаты "QR-оплата".