Платежные агрегаторы

В настоящий момент в QR-меню поддерживается оплата через 3х платежных агрегаторов: Робокасса, ЮКасса и Бест2Пей.

Плюсы: Дополнительно (при желании) можно фискализации оплаты на облачном фискальнике по агентской схеме (услуга «Робочеки»).
Гость оплачивает и получает электронный чек от платежного агрегатора. Агрегатор перечисляет вознаграждение в ресторан (за вычетом своего процента) по агентскому договору.
Минусы:

• Нельзя продавать алкоголь и пиво
• Более сложная регистрация (требуется большой список документов для заключения договора)
• Более высокий процент комиссии (примерно: 3,8% базовая ставка, плюс 1% при использовании Робочеков)

В Админской части QR-меню, в разделе «Настройки приложения» → «Настройки платежной системы», выбрать значение параметра «Режим проведения онлайн-платежа»: «Закрытие чека» или «Предоплата».

Важно!!! Для работы в режиме предоплаты нужно предварительно настроить предоплаты в r_keeper, а так же в разделе Параметры системы → Справочники r_keeper произвести дополнительные настройки. А именно: указать валюту онлайн платежа, причину внесения и выбрать работника от имени которого будет осуществляться оплата.

В разделе «Настройки приложения» → «Настройки платежной системы» выбрать платежного агрегатора «Робокасса».

Параметры платежного агента → Вписать значение из поля «Идентификатор магазина» из личного кабинета Робокассы.

В личном кабинете Робокассы заполнить поля «Result Url», «Success Url» и «Fail Url», значения для которых взять в самом низу на странице QR-меню.

Важно!!! Место отправки данных - POST

Для проведения платежей в ТЕСТОВОМ режиме (без реального списание денег с карты):
1. Включить данный режим в настройках приложения.
2. В личном кабинете Робокассы сгенерировать пароли для тестовых платежей и скопировать их в соответствующие поля настроек QR-меню.
Важно!!! Алгоритм расчета хэша - MD5

Для РЕАЛЬНОГО проведения платежей (деньги списываются с карты):
1. Отключить тестовый режим в настройках приложения.
2. В личном кабинете Робокассы сгенерировать пароли для платежей и скопировать их в соответствующие поля настроек QR-меню.
Важно!!! Алгоритм расчета хэша - MD5

Плюсы:

• Более низкий процент (~2,8)
• Более простая регистрация

Минусы: Нет облачных чеков (для QR-меню не актуально, т.к. бумажный чек гость получит в ресторане)

https://yookassa.ru/fees/

Как регистрироваться
Информация ниже актуальна в случае продажи алкоголя.
Дистанционная торговля алкоголем в РФ запрещена, поэтому в процессе регистрации в «Юкассе» нужно убедить их, что платёжный шлюз не будет использоваться для дистанционной торговли, что оплата и передача заказа происходит в торговом зале.

Тестовый контур
В личном кабинете ЮКАсса создать тестовый магазин.
«ЮКасса → Настройки → Магазин → 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 для уведомлений»
«О каких событиях уведомлять» - включить все.

Плюсы:

• Самый низкий процент (1%)
• Минимальный пакет документов
• Работа с любым банком (деньги поступают на р/с ресторана по безналу от Б2П)

Минусы: Нет облачных чеков (для QR-меню не актуально, т.к. бумажный чек гость получит в ресторане)

https://best2pay.net/

Первичные настройки QR-Menu

1. В настройках приложения QR-Menu включить онлайн оплаты
2. Выбрать подходящий режим проведения платежа
3. В блоке «Настройки платежной системы» выбрать платежного агента «Best2Pay»

Боевой контур
Ссылка на личный кабинет:
https://pay.best2pay.net/new-office/login.htm

1. Зайти в личный кабинет Б2П
2. В личном кабинете перейти во вкладку профиль
3. В разделе «Управление секторами»:
   • Скопировать значение поля «Номер сектора» в соответствующее поле в настройках QR-Menu
   • Скопировать значение поля «Пароль для подписи» в поле «Пароль для формирования цифровой подписи» в QR-Menu
4. В разделе «Уведомления»:
   • Нажать на кнопку «изменить» для поля «URL Уведомлений»
   • Скопировать значение поля «URL для Уведомлений» из QR-Menu и нажать на кнопку сохранить
5. Указать код валюты в настройках QR-Menu в поле «Код валюты» в соответствии ISO 4217
6. Сохранить настройки QR-Menu.

Тестовый контур
Ссылка на личный кабинет:
https://test.best2pay.net/new-office/login.htm

ВАЖНО!
При оплате в режиме тестовых платежей, запускается тестовый кейс на стороне Б2П с успешным завершением процесса оплаты.

1. Включить опцию «Проводить тестовые платежи»
2. Зайти в личный кабинет тестового контура Б2П
3. В личном кабинете перейти во вкладку профиль
4. В разделе «Управление секторами»:
   • Скопировать значение поля «Номер сектора» в соответствующее поле в настройках QR-Menu
   • Скопировать значение поля «Пароль для подписи» в поле «Пароль для формирования цифровой подписи» в QR-Menu
5. В разделе «Уведомления»:
   • Нажать на кнопку «изменить» для поля «URL Уведомлений»
   • Скопировать значение поля «URL для Уведомлений» из QR-Menu и нажать на кнопку сохранить
6. Указать код валюты в настройках QR-Menu в поле «Код валюты» в соответствии ISO 4217
7. Сохранить настройки QR-Menu

Коды валют по ISO 4217

• RUB: 643 (Установлено по умолчанию)
• EUR: 978
• USD: 840

Первичные настройки QR-Menu

1. В настройках приложения QR-Menu включить онлайн оплаты
2. Выбрать подходящий режим проведения платежа
3. В блоке «Настройки платежной системы» выбрать платежного агента «Paygine»

Боевой контур
Ссылка на личный кабинет:
https://pay.paygine.com/new-office/login.htm

1. Зайти в личный кабинет Paygine
2. В личном кабинете перейти во вкладку профиль
3. В разделе «Управление секторами»:
   • Скопировать значение поля «Номер сектора» в соответствующее поле в настройках QR-Menu
   • Скопировать значение поля «Пароль для подписи» в поле «Пароль для формирования цифровой подписи» в QR-Menu
4. В разделе «Уведомления»:
   • Нажать на кнопку «изменить» для поля «URL Уведомлений»
   • Скопировать значение поля «URL для Уведомлений» из QR-Menu и нажать на кнопку сохранить
5. Сохранить настройки QR-Menu.

Тестовый контур
Ссылка на личный кабинет:
https://test.paygine.com/new-office/login.htm

Тестовые карты выдаются платежным агентом и могут быть использованы для проведения платежей в тестовом режиме

1. Включить опцию «Проводить тестовые платежи»
2. Зайти в личный кабинет тестового контура Paygine
3. В личном кабинете перейти во вкладку профиль
4. В разделе «Управление секторами»:
   • Скопировать значение поля «Номер сектора» в соответствующее поле в настройках QR-Menu
   • Скопировать значение поля «Пароль для подписи» в поле «Пароль для формирования цифровой подписи» в QR-Menu
5. В разделе «Уведомления»:
   • Нажать на кнопку «изменить» для поля «URL Уведомлений»
   • Скопировать значение поля «URL для Уведомлений» из QR-Menu и нажать на кнопку сохранить
6. Сохранить настройки QR-Menu