Monobank — один з найпопулярніших еквайрів в Україні. Вебхук рахунку перевіряється підписом ECDSA, записує платіж на замовлення й оновлює його статус.
Як це працює
Вебхук рахунку
Monobank надсилає статус рахунку із заголовком x-sign на endpoint адаптера.
Запис платежу
Створюється рядок crm_order_payments із сумою і статусом.
Оновлення статусу
Замовлення переходить у «Підтверджено», якщо було «Очікує».
Безпека
- Підпис ECDSA/SHA-256 перевіряється публічним ключем мерчанта
- Публічний ключ отримується один раз і кешується, оновлюється лише при збої
- Дані картки не зберігаються (PAN/CVV) — лише сума, статус і id рахунку
- Привʼязка до замовлення через reference рахунку
Реальна перевірка зʼєднання
У налаштуваннях адаптера можна перевірити токен мерчанта в Monobank до будь-якого реального платежу — тест повертає підключеного мерчанта без запису платежу.
Налаштування
- 1
Додайте адаптер Monobank
Вкажіть токен мерчанта (X-Token) і скопіюйте webhook URL.
- 2
Вкажіть URL у Monobank
Використайте згенерований endpoint як webhook URL рахунку.
- 3
Перевірте зʼєднання
Запустіть перевірку зʼєднання, щоб підтвердити, що токен доходить до Monobank.
Часті запитання
Чи зберігаються дані картки?
Ні. Зберігаємо лише статус, суму й id рахунку — без PAN/CVV.
Як знаходиться правильне замовлення?
Reference рахунку з вебхука зіставляється з externalId замовлення в CRM.
Підключити Monobank
Оплати рухають статус замовлення автоматично.
Почати безкоштовно