====== Платежные агрегаторы ====== В настоящий момент в 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).** ===== Paygine (Method) ===== **Плюсы:** * Более низкий процент (2,5 для банковских карт, 1% для СБП) * Более простая и быстрая регистрация * Возможность настройки доступных методов для оплаты **Минусы:** Paygine (Method) - это сервис для интеграторов. Регистрация ресторанов производится через Carbis (что в общем-то даже проще для ресторана) https://paygine.ru/biznesu/internet-ekvayring/ Для использования данного платёжного шлюза напишите письмо на [[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