Skip to main content

Изменено: 08 ноября 2023

Плагин оплаты Модульбанк эквайринг

Плагин оплаты Модульбанк эквайринг

1. Общая информация

Плагин приёма оплаты через эквайринг Модульбанка на сайте под управлением RadicalMart.

Подробная информация о продукте, а также возможность скачивания и версионность доступны на странице плагина:

Страница продукта

1.1. Регистрация в сервисе

Для приёма оплаты на сайте, необходимо открыть РКО в Модульбанке и подключить услугу Интернет-эквайринга:

После выполнения данных шагов, можно приступить к настройке. Если вам нужна помощь по сопровождению приёма оплаты «под ключ» (консультация, помощь при взаимодействии с банком, настройка и тестирование оплаты) - вы можете обратиться к нам:

Заявка на сопровождение

1.2. Системные требования

Для нормального функционирования плагина, вам необходимо обеспечить следующие системные требования:


2. Настройка плагина на стороне RadicalMart

После успешной установки, перейдите в сайдбаре в RadicalMart > Способы оплаты. Переходите в настройки плагина Модульбанк.

2.1. Вкладка Настройки

Модульбанк для RadicalMart. Вкладка Настройки
Вкладка Настройки. Часть 1.

Переходим на вкладку Настройки и видим следующие параметры:

Настройки оплаты
  • Оплата доступна. Оплата товара становится доступной при выборе значения. По-умолчанию это Новый (новый заказ).
  • Статус оплачен. Смена статуса заказа после успешной оплаты.
  • Идентификатор магазина. Нужно взять в Личном Кабинете Модульбанка.
  • Рабочий секретный ключ. Нужно взять в Личном Кабинете Модульбанка.
  • Доступные способы оплаты. Опции: карты и СБП. Акцент на этом параметре, т.к. с его помощью можно принимать оплату несколькими методами.
  • Тестовый секретный ключ. Нужно взять в Личном Кабинете Модульбанка.
  • Режим отладки. Если включен, то никаких реальных перечислений денег не происходит.
  • Способ расчёта. Нужно для онлайн кассы.
  • Система налогообложения. Нужно для онлайн кассы. Подробнее здесь.
  • НДС. Нужно для онлайн кассы.
  • Предмет расчёта. Нужно для онлайн кассы.
Чек
  • Формировать чек (Да/нет). При отключении режима, данные по чеку не формируются.
Чек. Товар
  • Формировать чек (Да/нет). При отключении режима, данные по чеку не формируются.
  • НДС. Нужно для онлайн кассы.
  • Система налогообложения. Нужно для онлайн кассы. Подробнее здесь.
  • Способ расчёта. Нужно для онлайн кассы.
  • Предмет расчёта. Нужно для онлайн кассы.
Чек. Доставка
  • Формировать чек (Да/нет). При отключении режима, данные по чеку не формируются.
  • НДС. Нужно для онлайн кассы.
  • Система налогообложения. Нужно для онлайн кассы. Подробнее здесь.
  • Способ расчёта. Нужно для онлайн кассы.
  • Предмет расчёта. Нужно для онлайн кассы.

2.2. Вкладка Контент

Переходим по клику в название плагина и видим экран настроек. Настройки сгруппированы в две вкладки.

На первой вкладке Контент мы видим базовые параметры:

  • Иконка. Изображение метода оплаты, отображаемое на странице оформления заказа. Можно разместить логотип банка или изображения карт оплаты.
  • Описание. Текстовое описание, отображаемое на фронте на странице оформления заказа под логотипом и названием метода оплаты. Может использоваться для передачи дополнительной информации пользователю (см.изображение ниже).

2.3. Параметры в сайдбаре

  • По умолчанию. Метод оплаты, выбранный по-умолчанию. Параметры: да/нет.
  • Адрес выставления счёта. Параметр не задействан.
  • Язык. Выбор языка. Актуально, если необходимо конкретный способ оплаты привязать к определённому языку.
  • Состояние. Включить/выключить плагин оплаты.

3. Настройка личного кабинета в Модульбанке

Для настройки магазина в ЛК Модульбанка, вам необходимо авторизоваться на сайте сервиса и найти в шапке ссылку "Ещё" - откроется выпадающее меню со списком сервисов. Выбирайте Интернет-эквайринг. Появится выпадающее окно со списком Интернет-магазинов. Переходите в свой текущий магазин.

3.1. Способ первый

Переходите в Интеграция > Подключение через API
Настройка личного кабинета в Модульбанке

3.2. Способ второй

На странице https://pay.modulbank.ru/ в сайдбаре перейдите в пункт Интеграция.

Настройка личного кабинета в Модульбанке

Параметры подключения – скопируйте эти данные для использования в настройках метода оплаты. В обоих способах, это одни и те же параметры:

  • Идентификатор магазина = merchant_id
  • Тестовый секретный ключ = test_secret_key
  • Рабочий секретный ключ = secret_key

Callback для данного решения указывать не нужно, он срабатывает автоматически.

4. Настройка интеграции с онлайн кассами

4.1. Настройки на стороне RadicalMart

В настройках метода оплаты перечислены параметры, которые задействованы при формировании данных, которые будут задействованы при передаче фискальных данных.

Параметры фискализации
Параметры фискализации в настройках метода оплаты.
  • Система налогообложения.
    • Не передается
    • Общая система налогообложения (доход)
    • Упрощенная система налогообложения (доход)
    • Упрощенная система налогообложения (доход минус расход)
    • Единый налог на вменённый доход
    • Единый сельскохозяйственный налог
    • Патентная система налогообложения
  • НДС.
    • без НДС
    • НДС по ставке 0%
    • НДС чека по ставке 10%
    • НДС чека по расчетной ставке 10/110
    • НДС чека по ставке 20%
    • НДС чека по расчетной ставке 20/120
  • Способ расчёта.
    • Не передается
    • Полная предоплата
    • Частичная предоплата
    • Аванс
    • Полный расчёт
    • Частичный расчёт и кредит
    • Кредит
    • Выплата по кредиту
  • Предмет расчёта.
    • Не передается
    • Товар
    • Подакцизный товар
    • Работа
    • Услуга
    • Ставка азартной игры
    • Выигрыш азартной игры
    • Лотерейный билет
    • Выигрыш лотереи
    • Предоставление РИД
    • Платеж
    • Агентское вознаграждение
    • Составной предмет расчёта
    • Иной предмет расчёта
    • Имущественное право
    • Внереализационный доход
    • Страховые взносы
    • Торговый сбор
    • Курортный сбор

4.2. Настройка интеграции с онлайн-кассами в Личном кабинете Модульбанка

При подключении услуги Интернет-эквайринга, вы вам могут подключить услугу Облачные чеки. В этом случае, фискализация осуществляется на стороне Модульбанка. Никаких дополнительных действий осуществлять не нужно.

В случае, если вам требуется подключение внешнего сервиса для фискализации, соответствующую настройку можете найти в разделе Интернет-эквайринг.
Поддеживаемые сервисы: Модулькасса, Ferma.OFD, Атол.Онлайн (уточняйте актуальность информации в банке).

5. Часто задаваемые вопросы

5.1. При оплате заказа возникает ошибка. Что делать?

Вам нужно включить логирование транзакций и изучать логи на предмет наличия ошибок.

5.2. Как включить логирование транзакций?

Перейдите в панель администрирования > RadicalMart > Методы оплаты > Модульбанк.
Режим отладки – Да

После включения режима отладки, воспроизведите повторно ошибку при оплате заказа. Будет произведена запись в файл логов. Путь к файлу по-умолчанию:

/administrator/logs/plg_radicalmart_payment_modulbank.php

После изучения логов, не забудьте выключить режим логирования!

5.3. Статус заказа оплачен, но на странице заказа все равно отображается кнопка "Оплатить"

В настройках метода оплаты параметр Страница заказа содержит лишние статусы. Оставьте статус Новый.
Статус заказа новый

5.4. Ошибка при обновлении плагина из панели управления

В настройках магазина используется некорректный ключ или подписка на продукт просрочена. Необходимо продлить подписку в личном кабинете sovmart.ru и/или проверить ключ.

5.5. Где взять карты для проверки тестового режима?

Воспользуйтесь любой тестовой картой с валидным сроком. Введите в поиске Яндекса/Google ключевую фразу: тестовые карты МИР

6. Заявка на подключение

Мы можем помочь с подключением платёжной системы/эквайринга «под ключ», сопровождая вас на всех этапах, начиная от взаимодействия с банком при подключении услуг и заканчивая тестированием платежей. Услуга оговаривается индивидуально.

Ваше имя *
Укажите, как к Вам обращаться?
Ваш Telegram: *
Укажите свой номер телефона или алиас в Telegram
E-mail *
Укажите свой E-Mail
ОГРН/ОГРНИП
Дополнительные сведения: