====== Платежные агрегаторы ======
В настоящий момент в QR-меню поддерживается оплата через четырёх платежных агрегаторов: Paygine (method), Робокасса, ЮКасса и Бест2Пей.
^ Способ оплаты ^ Ставки платежных Агрегаторов, % ^^^^^
^ ::: ^ Робокасса ^ Юкасса ^ best2pay ^ Paygine (Method) ^ ^
^СБП | 1.8 | - | 1 | **1** ||
^Банковская карта | 3.9 | 3.5 | 3.2 | **2.5** ||
^Я Pay | 3.9 | 3.5 | 3.2 | **2.5** ||
^Mir Pay | 3.9 | 3.5 | 3.2 | **2.5** ||
^Sber Pay | 3.9 | 3.5 | 3.2 | **2.5** ||
*Сравнение сделано по ставкам на июль 2023
По совокупности всех показателей рекомендуемый (наиболее выгодный) вариант - ** Paygine (Method).**
===== Borica =====
От версии v1.14.63.1066 поддержана платёжная система "Borica" для рынка Болгарии.
Для того, чтобы настроить платежную систему "Borica", понадобиться:
1. Перейти в раздел "Настройки приложения", расположенный в дровере админской панели модуля QR Меню;
{{ :external:qr_меню:01_установка:2026-02-05_15-39-03.png |}}
2. Перейти в конец страницы и найти селектор "Разрешить онлайн оплаты"
{{ :external:qr_меню:01_установка:2026-02-05_11-28-01.png |}}
3. Перевести его в активное положение, после чего откроются дополнительный раздел "Настройка платежной системы"
{{ :external:qr_меню:01_установка:2026-02-05_11-42-02.png |}}
4. В выпадающем списке с названием "Выберите платежного агента", требуется выбрать требуемый платежный агент "Borica"
{{ :external:qr_меню:01_установка:borica_settings.png |}}
5. После этого требуется заполнить поля платежной агента в "Параметры платежного агента", где:
* Идентификатор терминала (TERMINAL) - Идентификатор платежного терминала
{{ :external:qr_меню:01_установка:2026-02-05_12-18-27.png |}}
* Тип операции (TRTYPE) - тип операции
{{ :external:qr_меню:01_установка:2026-02-05_12-20-38.png |}}
* Код валюты (CURRENCY) - требуемый буквенный код валюты, состоящий из трёх знаков (Пример: RUB, BGN, EUR и так далее)
{{ :external:qr_меню:01_установка:2026-02-05_12-38-36.png |}}
* Описание транзакции, которое увидит пользователь (DESCRIPTION) - описание транзакции, которое увидит пользователь при оплате заказа
{{ :external:qr_меню:01_установка:2026-02-05_12-23-36.png |}}
* Идентификатор продавца (MERCHANT) - уникальный идентификатор продавца
{{ :external:qr_меню:01_установка:2026-02-05_12-25-14.png |}}
* Наименование продавца (MERCH_NAME) - наименование продавца
{{ :external:qr_меню:01_установка:2026-02-05_12-26-34.png |}}
* Буквенный код страны (BG) - в поле требуется указать код страны, в которой происходит оплата( Например "BG")
{{ :external:qr_меню:01_установка:2026-02-05_12-40-04.png |}}
* Ключ продавца (M_INFO) - уникальный ключ продавца
{{ :external:qr_меню:01_установка:2026-02-05_16-09-31.png |}}
* Хэш (NONCE) - Случайная строка 32 байта фиксированной длины
{{ :external:qr_меню:01_установка:2026-02-05_12-31-51.png |}}
* Дополнение (ADDENDUM) - дополнение в поле указать "AD,TD"
{{ :external:qr_меню:01_установка:2026-02-05_12-41-40.png |}}
* Ссылка на банк (GETAWAY_URL) - url- используемого банка
{{ :external:qr_меню:01_установка:2026-02-05_12-35-32.png |}}
* Приватный ключ банка (PRIVATE KEY) - приватный ключ формата:
{{ :external:qr_меню:01_установка:2026-02-05_12-36-50.png |}}
**-----BEGIN PRIVATE KEY-----**
//В данном месте требуется указать приватный ключ выданный банком//
**-----END PRIVATE KEY-----**
===== Paygine (Method) =====
**Плюсы:**
* Более низкий процент (2,5 для банковских карт, 1% для СБП)
* Более простая и быстрая регистрация
* Возможность настройки доступных методов для оплаты
**Минусы:** Paygine (Method) - это сервис для интеграторов. Регистрация ресторанов производится через Carbis (что в общем-то даже проще для ресторана)
https://paygine.ru/
Для использования данного платёжного шлюза напишите письмо на [[info@carbis.ru]] с темой "нужен платёжный шлюз Paygine (Method) для QR-меню".
В ответ мы направим актуальные условия и список необходимых документов.
**Первичные настройки QR-Menu**
- В настройках приложения QR-Menu включить онлайн оплаты
- Выбрать подходящий режим проведения платежа
- В блоке "Настройки платежной системы" выбрать платежного агента "Paygine"
{{:external:qr_меню:01_установка:pasted:20230616-060455.png}}
**Боевой контур**
Ссылка на личный кабинет:
https://pay.paygine.com/new-office/login.htm
- Зайти в личный кабинет Paygine
- В личном кабинете перейти во вкладку профиль
- В разделе "Управление секторами":
* Скопировать значение поля "Номер сектора" в соответствующее поле в настройках QR-Menu
* Скопировать значение поля "Пароль для подписи" в поле "Пароль для формирования цифровой подписи" в QR-Menu
- В разделе "Уведомления":
* Нажать на кнопку "изменить" для поля "URL Уведомлений"
* Скопировать значение поля "URL для Уведомлений" из QR-Menu и нажать на кнопку сохранить
- **Сохранить настройки QR-Menu.**
{{:external:qr_меню:01_установка:pasted:20230616-060800.png}}
**Тестовый контур**
Ссылка на личный кабинет:
https://test.paygine.com/new-office/login.htm
**Тестовые карты выдаются платежным агентом и могут быть использованы для проведения платежей в тестовом режиме**
- Включить опцию "Проводить тестовые платежи"
- Зайти в личный кабинет тестового контура Paygine
- В личном кабинете перейти во вкладку профиль
- В разделе "Управление секторами":
* Скопировать значение поля "Номер сектора" в соответствующее поле в настройках QR-Menu
* Скопировать значение поля "Пароль для подписи" в поле "Пароль для формирования цифровой подписи" в QR-Menu
- В разделе "Уведомления":
* Нажать на кнопку "изменить" для поля "URL Уведомлений"
* Скопировать значение поля "URL для Уведомлений" из QR-Menu и нажать на кнопку сохранить
- **Сохранить настройки QR-Menu**
===== Робокасса =====
**Плюсы:** Дополнительно (при желании) можно фискализации оплаты на облачном фискальнике по агентской схеме (услуга "Робочеки").
Гость оплачивает и получает электронный чек от платежного агрегатора. Агрегатор перечисляет вознаграждение в ресторан (за вычетом своего процента) по агентскому договору.
**Минусы:**
* Нельзя продавать алкоголь и пиво
* Более сложная регистрация (требуется большой список документов для заключения договора)
* Более высокий процент комиссии (примерно: 3,8% базовая ставка, плюс 1% при использовании Робочеков)
**Настройка Робокасса:**
В Админской части QR-меню, в разделе "Настройки приложения" -> "Настройки платежной системы", выбрать значение параметра "Режим проведения онлайн-платежа": "Закрытие чека" или "Предоплата".
**Важно!!!** Для работы в режиме предоплаты нужно предварительно [[https://wiki.carbis.ru/external/qr_меню/01_установка/02_найстроки_rkeeper#настройка_предоплат|настроить предоплаты в r_keeper]], а так же в разделе Параметры системы -> Справочники r_keeper [[https://wiki.carbis.ru/external/qr_меню/01_установка/03_параметры_системы#справочники_r_keeper|произвести дополнительные настройки]]. А именно: указать валюту онлайн платежа, причину внесения и выбрать работника от имени которого будет осуществляться оплата.
В разделе "Настройки приложения" -> "Настройки платежной системы" выбрать платежного агрегатора "Робокасса".
Параметры платежного агента -> Вписать значение из поля "Идентификатор магазина" из личного кабинета Робокассы.
{{:external:qr_меню:01_установка:pasted:20220716-151840.png}}
В личном кабинете Робокассы заполнить поля "**Result Url**", "**Success Url**" и "**Fail Url**", значения для которых взять в самом низу на странице QR-меню.
**Важно!!!**
*"Метод отправки данных по Result Url" - POST
*"Метод отправки данных по Success Url" - GET
*"Метод отправки данных по Fail Url" - GET
{{:external:qr_меню:01_установка:20220716-154033.png}}
Для проведения платежей в **ТЕСТОВОМ** режиме (без реального списание денег с карты):
1. Включить данный режим в настройках приложения.
2. В личном кабинете Робокассы сгенерировать пароли для **тестовых** платежей и скопировать их в соответствующие поля настроек QR-меню.
**Важно!!!** Алгоритм расчета хэша - MD5
{{:external:qr_меню:01_установка:pasted:20220716-155747.png}}
Для **РЕАЛЬНОГО** проведения платежей (деньги списываются с карты):
1. Отключить тестовый режим в настройках приложения.
2. В личном кабинете Робокассы сгенерировать пароли для платежей и скопировать их в соответствующие поля настроек QR-меню.
**Важно!!!** Алгоритм расчета хэша - MD5
{{:external:qr_меню:01_установка:pasted:20220716-155840.png}}
===== ЮКасса =====
**Плюсы:**
* Более низкий процент (~2,8)
* Более простая регистрация
**Минусы:** Нет облачных чеков (для QR-меню не актуально, т.к. бумажный чек гость получит в ресторане)
https://yookassa.ru/fees/
**Настройка ЮКасса:**
**Как регистрироваться**
Информация ниже актуальна в случае продажи алкоголя.
Дистанционная торговля алкоголем в РФ запрещена, поэтому в процессе регистрации в "Юкассе" нужно убедить их, что платёжный шлюз не будет использоваться для дистанционной торговли, что оплата и передача заказа происходит в торговом зале.
{{:external:qr_меню:01_установка:pasted:20220705-095721.png}}
{{:external:qr_меню:01_установка:pasted:20220705-095813.png}}
{{:external:qr_меню:01_установка:pasted:20220705-100045.png}}
**Тестовый контур**
В личном кабинете ЮКАсса создать тестовый магазин.
"ЮКасса -> Настройки -> Магазин -> shopId" это значение вписать в "QR-меню -> Настройки приложения -> Настройки платежной системы -> Идентификатор магазина ЮКасса"
"ЮКасса -> Интеграция -> Ключи API -> Секретный ключ" это значение вписать в "QR-меню -> Настройки приложения -> Настройки платежной системы -> Секретный API ключ юкасса"
"QR-меню -> Настройки приложения -> Настройки платежной системы -> URL для уведомлений" это значение вписать в "ЮКасса -> Интеграция -> HTTP-уведомления -> URL для уведомлений"
"О каких событиях уведомлять" - включить все
**Важно!**
При работе с тестовым магазином ЮКасса для проведения платежей нужно использовать специальные номера карт
Для Visa:
* Номер карты - 4111111111111111
* Срок действия - любая дата (но больше текущей)
* CVC - любые 3 цифры
Подробнее тут https://yookassa.ru/developers/payment-acceptance/testing-and-going-live/testing#test-bank-card
Важно!
Чтобы сработала тестовая оплата, в "тестовом магазине" Юкассы не должна быть включена "онлайн-касса" (см. Настройки -> Онлайн-касса)
Помните о том что даже если платеж в ЮКасса проведен через тестовый магазин в r_keeper эта сумма упадет как оплата, и в зависимости от настроек валюты в r_keeper может быть выбит фискальный чек!
**Реальный контур**
В личном кабинете ЮКАсса создать реальный магазин
"ЮКасса -> Настройки -> Магазин -> shopId" это значение вписать в "QR-меню -> Настройки приложения -> Настройки платежной системы -> Идентификатор магазина ЮКасса"
"ЮКасса -> Интеграция -> Ключи API -> Секретный ключ" это значение вписать в "QR-меню -> Настройки приложения -> Настройки платежной системы -> Секретный API ключ юкасса"
"QR-меню -> Настройки приложения -> Настройки платежной системы -> URL для уведомлений" это значение вписать в "ЮКасса -> Интеграция -> HTTP-уведомления -> URL для уведомлений"
"О каких событиях уведомлять" - включить все.
{{:external:qr_меню:01_установка:pasted:20220504-165932.png}}
**Начиная с версии 1.14.26.1028**
Выберите режим оплаты для Юкассы (двух-стадийная оплата или оплата в одну стадию)
{{:external:qr_меню:01_установка:pasted:20240214-110524.png}}
Особенности: в настройках магазина "Способ подключения к Юкасса" должен быть " протокол API"
{{:external:qr_меню:01_установка:pasted:20230727-174110.png}}
{{:external:qr_меню:01_установка:pasted:20230727-174021.png}}
Особенности: в настройках магазина "онлайн-касса" должна быть отключена.
{{:external:qr_меню:01_установка:pasted:20230808-112028.png}}
===== СБП (через платежного агрегатора Бест2Пей) =====
**Плюсы:**
* Самый низкий процент (1%)
* Минимальный пакет документов
* Работа с любым банком (деньги поступают на р/с ресторана по безналу от Б2П)
**Минусы:** Нет облачных чеков (для QR-меню не актуально, т.к. бумажный чек гость получит в ресторане)
https://best2pay.net/
**Настройка СБП (Бест2Пей):**
**Первичные настройки QR-Menu**
- В настройках приложения QR-Menu включить онлайн оплаты
- Выбрать подходящий режим проведения платежа
- В блоке "Настройки платежной системы" выбрать платежного агента "Best2Pay"
{{:external:qr_меню:01_установка:pasted:20230512-112806.png}}
**Боевой контур**
Ссылка на личный кабинет:
https://pay.best2pay.net/new-office/login.htm
- Зайти в личный кабинет Б2П
- В личном кабинете перейти во вкладку профиль
- В разделе "Управление секторами":
* Скопировать значение поля "Номер сектора" в соответствующее поле в настройках QR-Menu
* Скопировать значение поля "Пароль для подписи" в поле "Пароль для формирования цифровой подписи" в QR-Menu
- В разделе "Уведомления":
* Нажать на кнопку "изменить" для поля "URL Уведомлений"
* Скопировать значение поля "URL для Уведомлений" из QR-Menu и нажать на кнопку сохранить
- Указать код валюты в настройках QR-Menu в поле "Код валюты" в соответствии ISO 4217
- **Сохранить настройки QR-Menu.**
{{:external:qr_меню:01_установка:pasted:20230512-115100.png}}
**Тестовый контур**
Ссылка на личный кабинет:
https://test.best2pay.net/new-office/login.htm
**ВАЖНО!**
При оплате в режиме тестовых платежей, запускается тестовый кейс на стороне Б2П с успешным завершением процесса оплаты.
- Включить опцию "Проводить тестовые платежи"
- Зайти в личный кабинет тестового контура Б2П
- В личном кабинете перейти во вкладку профиль
- В разделе "Управление секторами":
* Скопировать значение поля "Номер сектора" в соответствующее поле в настройках QR-Menu
* Скопировать значение поля "Пароль для подписи" в поле "Пароль для формирования цифровой подписи" в QR-Menu
- В разделе "Уведомления":
* Нажать на кнопку "изменить" для поля "URL Уведомлений"
* Скопировать значение поля "URL для Уведомлений" из QR-Menu и нажать на кнопку сохранить
- Указать код валюты в настройках QR-Menu в поле "Код валюты" в соответствии ISO 4217
- **Сохранить настройки QR-Menu**
**Коды валют по ISO 4217**
* RUB: 643 (Установлено по умолчанию)
* EUR: 978
* USD: 840
===== Сведения об юридическом лице =====
** Наименование юридического лица, принимающего платежи** - данное название будет размещено на странице веб-приложения. (Не передаётся в платёжный аггрегатор.)
** ИНН юридического лица принимающего платежи** - ИНН будет размещен на странице веб-приложения. (Не передаётся в платёжный аггрегатор.)
** Публичная оферта** - шаблон документа можно скачать по [[https://disk.yandex.ru/d/KYLHu75hWvra8A|этой ссылке]] и внутри приложения, подставить свои данные и перенести в поле публичной оферты.
{{ :external:qr_меню:01_установка:2025-09-15_10-39-15.png |}}
После настройки полей данные будут видны на первой странице веб-приложения. Для просмотра оферты на неё нужно нажать.
{{:external:qr_меню:01_установка:qrmenu_on_phone_1.png?300|}} {{:external:qr_меню:01_установка:qrmenu_on_phone_2.png?300|}}