(YR) Monobank Payment Gateway 1.0.0

Платіжний шлюз Monobank для Invision Community Commerce

(YR) Monobank Payment Gateway — платіжний модуль для інтеграції Monobank Acquiring з системою Commerce в Invision Community.

Додаток дозволяє вашим користувачам оплачувати товари, послуги та рахунки через Monobank безпосередньо під час оформлення замовлення на сайті.

Після створення платежу покупець переходить на захищену сторінку оплати Monobank. Результат платежу автоматично перевіряється та передається назад у Commerce.

Основні можливості

• Інтеграція Monobank Acquiring з Invision Community Commerce

• Створення платежів через офіційний API Monobank

• Підтримка платежів у UAH

• Автоматична перевірка статусу платежу

• Підтримка webhook-повідомлень Monobank

• Перевірка цифрового підпису webhook

• Автоматичне підтвердження успішної транзакції

• Фонове опрацювання платежів зі статусом Pending

• Повне повернення коштів (Refund)

• Часткове повернення коштів (Partial Refund)

• Перевірка суми, валюти та Invoice ID

• Захист від некоректних та підроблених webhook-запитів

• Merchant Token зберігається на сервері

• Налаштування шлюзу через ACP → Commerce

• Українська локалізація системних повідомлень

Як працює оплата

Покупець → Commerce → Monobank → Оплата → Webhook → Commerce

Після успішної оплати Monobank надсилає серверу повідомлення про статус транзакції. Модуль перевіряє отримані дані та підтверджує платіж у Commerce.

Якщо webhook затримався, фонове завдання додатка додатково перевіряє незавершені транзакції.

Встановлення

Додаток постачається готовим архівом .tar для встановлення через адміністративну панель Invision Community.

В ACP відкрийте розділ встановлення застосунків, виберіть завантаження нового застосунку та завантажте файл:

YR-Monobank-Payment-Gateway.tar

Після встановлення перейдіть:

ACP → Commerce → Payment Methods

Створіть/відкрийте платіжний метод Monobank та введіть свій Merchant Token Monobank Acquiring.

Збережіть налаштування та активуйте платіжний метод.

Важливо: для приймання реальних платежів продавець повинен мати власний активний Merchant Token Monobank Acquiring. Токен розробника в дистрибутив додатка не входить.

Повернення коштів

Модуль підтримує:

✓ Full Refund — повне повернення платежу
✓ Partial Refund — часткове повернення платежу

Операція виконується через API Monobank із перевіркою фактичного результату повернення.

Безпека

Для webhook реалізована перевірка підпису Monobank. Додатково перевіряються:

Invoice ID • Transaction • Amount • Currency • Gateway • Payment Status

Merchant Token не передається покупцю та використовується лише серверною частиною платіжного шлюзу.