Перейти к содержимому
Изменено: 06 февраля 2026

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

Плагин оплаты Модульбанк эквайринг
Оглавление
  1. Общая информация
  2. Настройка плагина на стороне RadicalMart
  3. Настройка магазина в личном кабинете Модульбанка
  4. Настройка интеграции с онлайн кассами
  5. Часто задаваемые вопросы
  6. Заявка на подключение

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

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

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

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

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

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

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

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

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

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

К оглавлению

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

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

2.1. Вкладка Содержимое

  • Иконка. Здесь можно выбрать изображение платежного метода, который отобразится на странице оформления заказа.
  • Описание. Краткое описание метода оплаты, который отображается на странице оформления заказа.

2.2. Вкладка Настройки оплаты

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

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

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

2.3. Вкладка Чек

Модульбанк для RadicalMart. Вкладка Настройки оплаты
Вкладка Чек. Часть 2.
Необходимо установить Плагин Фискализации. НДС, способ расчёта, предмет расчёта - см. Плагин Фискализации.
  • Формировать чек (Да / Нет). При отключении режима, данные по чеку не формируются.
Чек. Товар
Чек. Доставка

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

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

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

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

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

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

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

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

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

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

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

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

К оглавлению

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

Необходимо установить и настроить Плагин Фискализации.
К оглавлению

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

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

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

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

Перейдите в панель администрирования > RadicalMart > Настройки > вкладка Отладка и колонка Оплата — включить все режимы.

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

/administrator/logs/

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

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

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

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

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

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

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

5.6. Ошибка в поле client_phone: Некорректый телефон клиента

Модульбанк предъявляет требования к формату номера телефона покупателя.
Номер телефона должен быть в формате +7<10 цифр> или 8<10 цифр>.
Например: +7928 123-45-67 или 8928 1234567

Плагин оплаты передает данные в шлюз.

Во избежание ошибки с некорректным номером телефона, рекомендуем добавить к полю подсказку по правильному формату и осуществлять валидацию поля телефона на стороне оформления заказа.
Некорректый телефон клиента

5.7. Ошибка в поле signature: Неверное значение поля signature

Такая ошибка происходит при неправильном значении секретного ключа. Проверьте, правильно ли указаны ключи для боевого и тестового режима.
К оглавлению

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

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

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