Если вы решили сотрудничать с maib для обработки платежей по картам (Visa/Mastercard/Apple Pay), важно знать, что этот процесс сложнее, чем простое «plug-and-play». Он включает в себя два критически важных этапа: Бюрократия (Заключение контракта) и Техническая реализация (Сертификаты безопасности).
1. Административный этап: Подписание контракта
Вы не сможете начать техническую интеграцию без подтверждения вас банком в качестве коммерческого партнера.
Шаги, которые необходимо предпринять:
- Заявка на E-commerce: Вы подаете запрос в филиал, где у вас открыт юридический счет, или онлайн через вашего менеджера.
- Проверка сайта: Банк проведет аудит вашего сайта (даже если он находится на стадии демо). Сайт обязательно должен содержать:
- Контактные данные и IDNO компании в футере (подвале) сайта.
- Страницу «Условия и положения».
- Политику конфиденциальности (GDPR).
- Политику доставки и Политику возврата (очень важны для банков).
- Видимые логотипы Visa и Mastercard.
- Подписание контракта: Вы согласуете комиссию (interchange fee) и подпишете соглашение об «Приеме платежей по банковским картам в виртуальной среде».
2. Технический этап: Внедрение в WooCommerce
В отличие от других процессоров, maib использует систему, основанную на Сертификатах безопасности (.pem), которые должны быть установлены на вашем сервере.
A. Получение учетных данных
После подписания контракта IT-отдел банка отправит вам:
- Terminal ID и Merchant ID.
- Архив с тестовыми сертификатами (открытый и закрытый ключи).
- Документацию API (E-commerce Gateway).
B. Установка на WordPress (WooCommerce)
Поскольку в WordPress нет нативного модуля maib, вам понадобится специализированный плагин для Республики Молдова.
-
Получение комплекта: Как только контракт подписан и ваше досье обработано, вы получите официальное письмо от технической команды maib. Это письмо содержит как инструкции по настройке, так и официальный плагин maib (архив .zip), готовый к установке.
-
Сама установка:
-
Скачайте архив, прикрепленный к письму.
-
Перейдите в панель управления WordPress в раздел Плагины (Plugins) -> Добавить новый -> Загрузить плагин.
-
Выберите архив, присланный банком, и нажмите Установить.
-
-
Настройка и эндпоинты (Endpoints):
-
После активации перейдите в настройки модуля в WooCommerce.
-
Введите идентификационные данные, указанные в письме (Terminal ID, Merchant ID).
-
Настройте Callback URL (URL для получения уведомлений о платежах). Это необходимо для того, чтобы сервер банка мог автоматически связаться с вашим сайтом и отметить заказ как «Оплачен» сразу после завершения транзакции.
-
3. Кастомная интеграция (Non-WordPress)
Если ваш сайт построен на Laravel, Python или Node.js, вам придется внедрять протокол 3D Secure вручную.
- Протокол: maib обычно использует протокол, основанный на цифровой подписи.
- Поток данных:
- Сайт отправляет запрос на сервер maib с суммой и ID транзакции.
- Клиент перенаправляется на защищенную страницу банка.
- После оплаты сервер банка отправляет сигнал (POST-запрос) на ваш сервер.
- Проверка подписи: Ваш сервер должен подтвердить, что ответ действительно пришел от 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.
- Помощь в подготовке обязательных юридических страниц.
- Настройку сервера для максимальной безопасности.
- Поддержку после интеграции.
