Платежные агрегаторы [База знаний ГК Карбис]

Эта страница только для чтения. Вы можете посмотреть её исходный текст, но не можете его изменить. Сообщите администратору, если считаете, что это неправильно.
====== Платежные агрегаторы ======
В настоящий момент в 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" для рынка Болгарии.
<hidden>
Для того, чтобы настроить платежную систему "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-----**


</hidden>

===== Paygine (Method) =====

<hidden>

**Плюсы:**
  * Более низкий процент (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**

</hidden>


===== Робокасса =====

<hidden>

**Плюсы:** Дополнительно (при желании) можно фискализации оплаты на облачном фискальнике по агентской схеме (услуга "Робочеки").
Гость оплачивает и получает электронный чек от платежного агрегатора. Агрегатор перечисляет вознаграждение в ресторан (за вычетом своего процента) по агентскому договору.
**Минусы:** 
  * Нельзя продавать алкоголь и пиво 
  * Более сложная регистрация (требуется большой список документов для заключения договора)
  * Более высокий процент комиссии (примерно: 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}}
</hidden>

===== ЮКасса =====
<hidden>
**Плюсы:**
  * Более низкий процент (~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}}
</hidden>

===== СБП (через платежного агрегатора Бест2Пей) =====

<hidden>

**Плюсы:**
  * Самый низкий процент (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
</hidden>


===== Сведения об юридическом лице =====

** Наименование юридического лица, принимающего платежи** - данное название будет размещено на странице веб-приложения. (Не передаётся в платёжный аггрегатор.)
** ИНН юридического лица принимающего платежи** - ИНН будет размещен на странице веб-приложения. (Не передаётся в платёжный аггрегатор.)
** Публичная оферта** - шаблон документа можно скачать по [[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|}}