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

Для того чтобы настроить платёжную систему «Borica», понадобятся:

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

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

Идентификатор терминала (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

В настройках приложения QR-Menu включить онлайн-оплаты.

Выбрать подходящий режим проведения платежа.

В блоке «Настройки платежной системы» выбрать платёжного агента «Paygine».

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

Зайти в личный кабинет Paygine.

В личном кабинете перейти во вкладку «Профиль».

В разделе «Управление секторами»:

Скопировать значение поля «Номер сектора» в соответствующее поле в настройках QR-Menu.

Скопировать значение поля «Пароль для подписи» в поле «Пароль для формирования цифровой подписи» в QR-Menu.

В разделе «Уведомления»:

Нажать на кнопку «Изменить» для поля «URL Уведомлений».

Скопировать значение поля «URL для Уведомлений» из QR-Menu и нажать кнопку «Сохранить».

Сохранить настройки QR-Menu.

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

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

Включить опцию «Проводить тестовые платежи».

Зайти в личный кабинет тестового контура Paygine.

В личном кабинете перейти во вкладку «Профиль».

В разделе «Управление секторами»:

Скопировать значение поля «Номер сектора» в соответствующее поле в настройках QR-Menu.

Скопировать значение поля «Пароль для подписи» в поле «Пароль для формирования цифровой подписи» в QR-Menu.

В разделе «Уведомления»:

Нажать на кнопку «Изменить» для поля «URL Уведомлений».

Скопировать значение поля «URL для Уведомлений» из QR-Menu и нажать кнопку «Сохранить».

Сохранить настройки 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.

Для проведения платежей в ТЕСТОВОМ режиме (без реального списания денег с карты):

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

В личном кабинете Робокассы сгенерировать пароли для тестовых платежей и скопировать их в соответствующие поля настроек QR-меню.
Важно!!! Алгоритм расчёта хэша — MD5.

Для РЕАЛЬНОГО проведения платежей (деньги списываются с карты):

Отключить тестовый режим в настройках приложения.

В личном кабинете Робокассы сгенерировать пароли для платежей и скопировать их в соответствующие поля настроек 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

В настройках приложения QR-Menu включить онлайн-оплаты.

Выбрать подходящий режим проведения платежа.

В блоке «Настройки платежной системы» выбрать платёжного агента «Best2Pay».

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

Зайти в личный кабинет Б2П.

В личном кабинете перейти во вкладку «Профиль».

В разделе «Управление секторами»:

Скопировать значение поля «Номер сектора» в соответствующее поле в настройках QR-Menu.

Скопировать значение поля «Пароль для подписи» в поле «Пароль для формирования цифровой подписи» в QR-Menu.

В разделе «Уведомления»:

Нажать на кнопку «Изменить» для поля «URL Уведомлений».

Скопировать значение поля «URL для Уведомлений» из QR-Menu и нажать кнопку «Сохранить».

Указать код валюты в настройках QR-Menu в поле «Код валюты» в соответствии с ISO 4217.

Сохранить настройки QR-Menu.

Тестовый контур
Ссылка на личный кабинет:
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

Инструкция по настройке Монеты для QRMenu
Настройки платёжной системы «Монета» на стороне сервера QRMenu выглядят так:

Для корректной работы необходимо указать значения во всех представленных полях.
По параметрам:

Настройки тестовой среды переключает флаг «Проводить тестовые платежи». При включении будет использоваться демо-среда, иначе — продуктовая продуктовая. Следующие данные указываются в зависимости от выбранной среды.

Почта/логин и пароль — указываются данные для доступа к личному кабинету.

Номер счёта плательщика: берётся в личном кабинете (см. Рабочий кабинет > Способ оплаты > Номера счетов).

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

\

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

\

Для подключения интеграции требуется подключить и настроить интернет-эквайринг на стороне Т-банка. Подробнее о настройке личного кабинета и подключении интернет-эквайринга тут.
Для использования на стороне QR-меню платёжного агрегатора Т-банк потребуется:

Перейти на страницу «Настройки оплаты» и включить «Разрешить онлайн-оплаты», после чего появятся дополнительные поля.

Выбрать платёжного агента в выпадающем списке.

Ввести данные из личного кабинета Т-банка.

TerminalKey — идентификатор терминала из личного кабинета.
Пароль терминала — пароль терминала для подписи запросов (token).