PayMaster (только СБП)

Настройки в Mercury

Откройте Розница → Интернет-витрина → Оплаты. Включите оплату заказов и выберите в поле «Платёжная система» вариант «PayMaster (СБП)». После этого появятся поля подключения.

merchantId

Идентификатор вашего магазина в PayMaster. Он позволяет платёжному сервису определить, от имени какого магазина создаётся счёт на оплату.

Вставьте UUID магазина из личного кабинета PayMaster в поле merchantId. В подсказке поля указано «UUID магазина».

Токен API

Токен для доступа Mercury к API PayMaster. Он используется при создании счетов, проверке состояния платежей и выполнении операций с оплатой.

Скопируйте токен из кабинета PayMaster и вставьте его в поле «Токен API». Не передавайте его посторонним: это секретные данные для подключения к вашему магазину.

После сохранения токен не отображается в форме. Если при повторном открытии поле пустое, это не означает, что токен удалён. Пустое поле при повторном сохранении означает, что ранее сохранённый токен нужно оставить без изменений. Вводите новое значение только при необходимости заменить старое.

Тестовый режим PayMaster

Этот переключатель определяет, будут ли создаваемые счета помечаться как тестовые.

• Включён — счета создаются в тестовом режиме.
• Выключен — создаются обычные счета для приёма реальных платежей.

Используйте тестовый режим при проверке подключения. Перед началом приёма платежей от покупателей убедитесь, что настройки соответствуют рабочему режиму.

Сохранение настроек

Перед сохранением проверьте:

• включена ли оплата заказов интернет-витрины;
• выбран ли провайдер «PayMaster (СБП)»;
• правильно ли указан merchantId;
• вставлен ли действующий API-токен;
• выбран ли нужный режим работы.

Нажмите «Сохранить» в блоке онлайн-оплаты.

Использование в Mercury-POS

Идентификатор магазина и API-токен PayMaster могут также использоваться в карточке кассы Mercury-POS для настройки оплаты по СБП с помощью таблички с QR-кодом.

Подробнее: настройка кассы и работа с прайсом.

Настройка кабинета PayMaster

1. Откройте сайт PayMaster и войдите в личный кабинет.
2. Убедитесь, что у вас оформлен договор и подключён приём платежей через СБП.
3. Найдите идентификатор магазина merchantId и скопируйте его.
4. Получите токен API и скопируйте его.
5. Откройте Mercury: Розница → Интернет-витрина → Оплаты.
6. Выберите PayMaster, заполните поля merchantId и «Токен API».
7. При необходимости включите тестовый режим.
8. Нажмите «Сохранить».

Настройка Callback URL

PayMaster должен отправлять Mercury уведомления об изменении состояния платежей. Для этого в кабинете PayMaster необходимо указать адрес Callback URL.

1. После сохранения настроек найдите в Mercury поле «URL уведомлений».
2. Нажмите «Копировать».
3. Откройте настройки уведомлений в личном кабинете PayMaster.
4. Укажите скопированный адрес в качестве Callback URL.
5. Сохраните настройки.

Mercury также передаёт этот адрес при создании каждого счёта. Поэтому используйте именно URL из настроек витрины, а не адрес, составленный вручную.

Документация API PayMaster: paymaster.ru/docs/ru/api.

Подробнее об адресах уведомлений: URL уведомлений.

Оплата и возврат денег

Создание платежа

1. Откройте заказ на планшете KDS.
2. Нажмите «Оплата».
3. Mercury создаст счёт в PayMaster и получит ссылку на страницу оплаты СБП.
4. Ссылка отправляется покупателю в бот.
5. Покупатель открывает страницу оплаты и выполняет платёж через СБП.

В этом сценарии PayMaster используется только для СБП. Оплата картой или другим способом через него не предлагается.

Подтверждение оплаты

После завершения платежа PayMaster отправляет уведомление в Mercury. Система дополнительно проверяет состояние платежа через API.

Когда платёж получает подтверждённый статус Settled, в заказе устанавливается статус «Оплачено».

Возврат денег

В карточке заявки предусмотрена команда «Вернуть оплату». Она запускает операцию отмены или возврата платежа через PayMaster.

Конкретная операция зависит от состояния платежа. После выполнения возврата Mercury обновляет состояние оплаты в заявке.