</>
maximorum.com

Як інтегрувати Monobank у WordPress інтернет-магазин: практичний посібник

D

Monobank — одна з найпопулярніших платіжних систем в Україні. Понад 8 мільйонів активних користувачів очікують побачити знайому кнопку оплати у вашому інтернет-магазині. Для WordPress-магазинів підключення Monobank не потребує місяців розробки — але потребує правильної архітектури.

WordPress WooCommerce з інтеграцією Monobank на моніторі розробника

Як працює Monobank API

Monobank надає Acquiring API для прийому онлайн-платежів. Основний флоу:

  1. Ваш сайт викликає POST /api/merchant/invoice/create і отримує pageUrl для перенаправлення
  2. Покупець підтверджує оплату в додатку або на сторінці Monobank
  3. Monobank надсилає webhook на ваш сервер зі статусом транзакції
  4. Ваш магазин підтверджує платіж і оновлює статус замовлення

Ключовий момент: webhook-повідомлення повинні оброблятися ідемпотентно. Один і той самий платіж може прийти двічі — ваша система має впоратися з цим коректно.

Варіанти інтеграції для WordPress

1. WooCommerce Payment Gateway плагін
Найшвидший шлях для стандартних магазинів. Ви реєструєте клас, що розширює WC_Payment_Gateway, і підключаєте Monobank API через офіційний PHP SDK або власний HTTP-клієнт.

2. Кастомна інтеграція через WordPress REST API
Підходить для headless WordPress або магазинів з нестандартним checkout-флоу. Обробник платежів реалізується як REST-ендпоінт (register_rest_route), логіка ізолюється від теми.

3. Через платіжний агрегатор
LiqPay, WayForPay або Fondy вже мають офіційні WordPress-плагіни і підтримують картки Mono. Мінус: комісія агрегатора поверх комісії Monobank.

Що варто перевірити перед запуском

  • Валідація підпису webhook (X-Sign заголовок) — обов'язкова, інакше будь-хто може підробити підтвердження платежу
  • Логування кожного webhook-запиту для аудиту і налагодження
  • Повторні спроби обробки при тимчасових помилках (база даних недоступна, таймаут)
  • Тестування в sandbox-режимі Monobank перед виходом у продакшн
  • SSL-сертифікат — Monobank не надсилає webhooks на HTTP-сайти

Реальний результат

WordPress-магазин одягу з 300–500 замовленнями на місяць. Після інтеграції Monobank конверсія оплати зросла на 18% — частина покупців просто не завершувала оплату через незнайомі платіжні форми. Додавання Monobank Pay (оплата в один дотик для клієнтів Mono) дало ще +7% до конверсії серед мобільних користувачів.

Технічні вимоги

  • PHP 7.4+ (рекомендовано PHP 8.2)
  • WordPress 6.0+, WooCommerce 8.0+ (для плагін-підходу)
  • Публічно доступний HTTPS-ендпоінт для webhook
  • Merchant-акаунт у Monobank Business

Стандартна інтеграція займає 3–5 робочих днів. Складніші сценарії (split-оплата, підписки, recurring billing) — до 2 тижнів.

Команда MaxiMoruM має досвід інтеграції українських платіжних сервісів — Monobank, LiqPay, WayForPay — у WordPress та Laravel-проєкти. Розкажіть нам про ваш проєкт на maximorum.com.

Maximus AI
Online
Привіт! Я ваш AI-асистент. Чим можу допомогти з вашим проектом?