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

Для того, чтобы настроить платежную систему «Borica», понадобиться:
1. Перейти в раздел «Настройки приложения», расположенный в дровере админской панели модуля QR Меню;

2. Перейти в конец страницы и найти селектор «Разрешить онлайн оплаты»

3. Перевести его в активное положение, после чего откроются дополнительный раздел «Настройка платежной системы»

4. В выпадающем списке с названием «Выберите платежного агента», требуется выбрать требуемый платежный агент «Borica»

5. После этого требуется заполнить поля платежной агента в «Параметры платежного агента», где:

• Идентификатор терминала (TERMINAL) - Идентификатор платежного терминала

• Тип операции (TRTYPE) - тип операции

• Код валюты (CURRENCY) - требуемый буквенный код валюты, состоящий из трёх знаков (Пример: RUB, BGN, EUR и так далее)

• Описание транзакции, которое увидит пользователь (DESCRIPTION) - описание транзакции, которое увидит пользователь при оплате заказа

• Идентификатор продавца (MERCHANT) - уникальный идентификатор продавца

• Наименование продавца (MERCH_NAME) - наименование продавца

• Буквенный код страны (BG) - в поле требуется указать код страны, в которой происходит оплата( Например «BG»)

• Ключ продавца (M_INFO) - уникальный ключ продавца

• Хэш (NONCE) - Случайная строка 32 байта фиксированной длины

• Дополнение (ADDENDUM) - дополнение в поле указать «AD,TD»

• Ссылка на банк (GETAWAY_URL) - url- используемого банка

• Приватный ключ банка (PRIVATE KEY) - приватный ключ формата:

—–BEGIN PRIVATE KEY—–
В данном месте требуется указать приватный ключ выданный банком
—–END PRIVATE KEY—–

Плюсы:

• Более низкий процент (2,5 для банковских карт, 1% для СБП)
• Более простая и быстрая регистрация
• Возможность настройки доступных методов для оплаты

Минусы: Paygine (Method) - это сервис для интеграторов. Регистрация ресторанов производится через Carbis (что в общем-то даже проще для ресторана)

https://paygine.ru/

Для использования данного платёжного шлюза напишите письмо на info@carbis.ru с темой «нужен платёжный шлюз Paygine (Method) для QR-меню».
В ответ мы направим актуальные условия и список необходимых документов.

Первичные настройки 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

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

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

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

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

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

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

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

Важно!!!

• «Метод отправки данных по Result Url» - POST
• «Метод отправки данных по Success Url» - GET
• «Метод отправки данных по Fail Url» - GET

Для проведения платежей в ТЕСТОВОМ режиме (без реального списание денег с карты):
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.14.26.1028
Выберите режим оплаты для Юкассы (двух-стадийная оплата или оплата в одну стадию)

Особенности: в настройках магазина «Способ подключения к Юкасса» должен быть « протокол API»

Особенности: в настройках магазина «онлайн-касса» должна быть отключена.

Плюсы:

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

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

https://best2pay.net/

Настройка СБП (Бест2Пей):
Первичные настройки 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

Инструкция по настройке Монеты для QRMenu

Настройки платежной системы Монета на стороне сервера QRMenu выглядят так

Для корректной работы необходимо указать значения во всех представленных полях.
По параметрам:
1. Настройки тестовой среды переключает флаг «Проводить тестовые платежи». При включении будет использоваться демо-среда , иначе используется продуктовая продуктовая . Следующие данные указываются в зависимости от выбранной среды
2. Почта/логин и пароль - указываются данные для доступа к личному кабинету.
3. Номер счёта плательщика: берётся в личном кабинете. См. Рабочий кабинет > Способ оплаты > Номера счетов

4. Номер счёта получателя: также берётся в личном кабинете. Можно найти во вкладке Мой счёт > Управление счетами (см.скрин)

5. Для корректной работы нужны настройки на стороне платёжной системы. Настройки производятся во вкладке Мой счёт > Управление счетами > Редактировать счет.
Далее нужно нажать «Показать дополнительные поля». Для работы необходимо вставить три ссылки, сами ссылки можно взять из QRMenu.
В «Pay URL» подставляется значение из настроек QRMenu «URL для уведомлений».
Success и Fail URL берутся из соответствующих полей в QRMenu