Новости

Новости

Полный гид: Интеграция платежей maib в WordPress и Custom (Техническая и Административная часть)

Если вы решили сотрудничать с maib для обработки платежей по картам (Visa/Mastercard/Apple Pay), важно знать, что этот процесс сложнее, чем простое «plug-and-play». Он включает в себя два критически важных этапа: Бюрократия (Заключение контракта) и Техническая реализация (Сертификаты безопасности).

1. Административный этап: Подписание контракта

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

Шаги, которые необходимо предпринять:

  1. Заявка на E-commerce: Вы подаете запрос в филиал, где у вас открыт юридический счет, или онлайн через вашего менеджера.
  2. Проверка сайта: Банк проведет аудит вашего сайта (даже если он находится на стадии демо). Сайт обязательно должен содержать:
    • Контактные данные и IDNO компании в футере (подвале) сайта.
    • Страницу «Условия и положения».
    • Политику конфиденциальности (GDPR).
    • Политику доставки и Политику возврата (очень важны для банков).
    • Видимые логотипы Visa и Mastercard.
  3. Подписание контракта: Вы согласуете комиссию (interchange fee) и подпишете соглашение об «Приеме платежей по банковским картам в виртуальной среде».

2. Технический этап: Внедрение в WooCommerce

В отличие от других процессоров, maib использует систему, основанную на Сертификатах безопасности (.pem), которые должны быть установлены на вашем сервере.

A. Получение учетных данных

После подписания контракта IT-отдел банка отправит вам:

  • Terminal ID и Merchant ID.
  • Архив с тестовыми сертификатами (открытый и закрытый ключи).
  • Документацию API (E-commerce Gateway).

B. Установка на WordPress (WooCommerce)

Поскольку в WordPress нет нативного модуля maib, вам понадобится специализированный плагин для Республики Молдова.

  1. Получение комплекта: Как только контракт подписан и ваше досье обработано, вы получите официальное письмо от технической команды maib. Это письмо содержит как инструкции по настройке, так и официальный плагин maib (архив .zip), готовый к установке.

  2. Сама установка:

    • Скачайте архив, прикрепленный к письму.

    • Перейдите в панель управления WordPress в раздел Плагины (Plugins) -> Добавить новый -> Загрузить плагин.

    • Выберите архив, присланный банком, и нажмите Установить.

  3. Настройка и эндпоинты (Endpoints):

    • После активации перейдите в настройки модуля в WooCommerce.

    • Введите идентификационные данные, указанные в письме (Terminal ID, Merchant ID).

    • Настройте Callback URL (URL для получения уведомлений о платежах). Это необходимо для того, чтобы сервер банка мог автоматически связаться с вашим сайтом и отметить заказ как «Оплачен» сразу после завершения транзакции.


3. Кастомная интеграция (Non-WordPress)

Если ваш сайт построен на Laravel, Python или Node.js, вам придется внедрять протокол 3D Secure вручную.

  • Протокол: maib обычно использует протокол, основанный на цифровой подписи.
  • Поток данных:
    1. Сайт отправляет запрос на сервер maib с суммой и ID транзакции.
    2. Клиент перенаправляется на защищенную страницу банка.
    3. После оплаты сервер банка отправляет сигнал (POST-запрос) на ваш сервер.
    4. Проверка подписи: Ваш сервер должен подтвердить, что ответ действительно пришел от maib, используя открытый ключ банка.

4. Нюансы и технические «ловушки» (Внимание!)

Исходя из нашего опыта в Keywords.md, вот где чаще всего возникают проблемы:

  • Статический IP: maib часто требует, чтобы сервер вашего сайта имел статический IP для добавления его в список разрешенных (Allowlist). Если вы используете дешевый хостинг с общим IP, оплата может не работать.
  • Версия PHP: Некоторые модули maib требуют специфических версий PHP и активированного расширения openssl.
  • Тестовый период (Sandbox): Вы не можете сразу начать принимать реальные деньги. Необходимо провести минимум 2-3 успешные тестовые транзакции (специальными тестовыми картами), которые банк подтвердит в своей системе.
  • Переход в продакшн (Live): После валидации вы получите новый набор сертификатов (Live), которые заменят тестовые.

Сводная таблица: Чек-лист интеграции maib

Этап Ответственный Что нужно сделать/получить
Юридический Владелец бизнеса Подписанный контракт + текущий счет в maib
Документы сайта Копирайтер / Юрист Страницы возврата, конфиденциальности, контактов
Сервер SysAdmin / Keywords.md Статический IP + SSL-сертификат (HTTPS)
Настройка Программист / Keywords.md Установка плагина + Terminal ID
Валидация Банк + Программист / Keywords.md Проведение транзакций в среде Sandbox (Тест)

Заключение: Стоит ли оно того?

Хотя интеграция maib более технически сложная, чем у агрегаторов, преимущества значительны: самые низкие комиссии на рынке и уровень доверия клиентов в 99%.

Не хотите забивать голову ошибками сервера и настройкой плагина?

Интеграция maib — одна из наших специализаций в Keywords.md. Мы берем на себя весь технический процесс: от общения с программистами банка до финального тестирования транзакций на вашем сайте.

Мы предлагаем:

  • Установку и настройку модуля maib для WooCommerce.
  • Помощь в подготовке обязательных юридических страниц.
  • Настройку сервера для максимальной безопасности.
  • Поддержку после интеграции.

👉 Запросить техническую помощь в интеграции maib