Инструкция по подключению оплаты через QRManager в Marquiz

Как принимать оплату по QR‑коду в Marquiz с помощью QRManager

QRManager — это один из способов оплаты в Marquiz, чтобы принимать платежи по QR‑кодам и платёжным ссылкам в квизе.

Как добавить QRManager:

1. Открываем редактор квиза и добавляем блок «Оплата». Переходим в раздел настроек оплат и выбираем способ оплаты QRManager.

2. Настраиваем QRManager

— Открываем вкладку «Настройки», чтобы привязать аккаунт QRManager к квизу, для приёма оплат.

— Вставляем API‑ключ, выданный сервисом QRManager. Поле «Назначение платежа», нужно заполнить на своё усмотрение, если поле оставить пустым, в подпись подставится название товара (карточки результата).

3. Если включаем онлайн-кассу в настройках, то можно будет настроить:

НДС — указываем ставку НДС, которая будет передаваться в QRManager.
Ссылку на страницу после оплаты — вводим URL страницы, на которую будет перенаправлен клиент после успешной оплаты.
Способ оплаты — выбираем тип расчёта, который будет передаваться в QRManager и в чек.
Признак предмета расчёта — указываем, что именно покупает клиент, чтобы корректно отразить позицию в фискальном чеке (товары, работа, услуга или другое)
Единица измерения — выбираем, в каких единицах указывается количество товара или услуги. Это значение будет передано в QRManager и использовано при формировании чека.

4. Публикуем квиз и проверяем подключение.

При успешном подключении: «Интеграция с QRManager успешно сохранена».

При ошибке (например, неверный API‑ключ или проблема соединения): «Ошибка: недействительный API-ключ или ошибка соединения с QRManager». В этом случае:

проверьте правильность API‑ключа;
убедитесь, что доступ к API QRManager не блокируется (firewall, сеть);
повторно сохраните настройки.

6. Передача полей в QRManager

При создании платежа из Marquiz в QRManager передаются следующие поля:

sum — сумма за всю покупку в копейках.
qr-size — размер QR‑кода. Допустимые значения: от 100 до 1000. Рекомендуется подобрать оптимальный размер экспериментально в зависимости от дизайна квиза.
name — наименование товара/услуги или результата квиза.
count — количество позиций.
price — цена за единицу товара/услуги.
notification_url — URL вебхука для уведомлений об оплате. Вебхук уже преднастроен в интеграции и указывает на адрес https://api.marquiz.ru/quiz-payment/qrmanager/pay, поэтому создавать его вручную не требуется.

Чтобы получать статусы платежей, убедитесь, что этот URL вебхука указан в настройках QRManager.