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

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

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

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

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

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

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

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

1. НДС — указываем ставку НДС, которая будет передаваться в QRManager.

2. Ссылку на страницу после оплаты — вводим URL страницы, на которую будет перенаправлен клиент после успешной оплаты.

3. Способ оплаты — выбираем тип расчёта, который будет передаваться в QRManager и в чек. 

4. Признак предмета расчёта — указываем, что именно покупает клиент, чтобы корректно отразить позицию в фискальном чеке (товары, работа, услуга или другое)

5. Единица измерения — выбираем, в каких единицах указывается количество товара или услуги. Это значение будет передано в 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.