Так. Krokul CRM підключається до інтернет-еквайрингу monobank (Plata by mono) без коду. Менеджер створює посилання на оплату з угоди, клієнт платить на платіжній сторінці, а вебхук monobank переводить планову оплату у факт і перераховує оплачене по угоді.
Менеджер натискає «Посилання на оплату» в угоді. Krokul створює в monobank рахунок методом invoice/create на суму планової оплати й показує pageUrl, який можна надіслати клієнту в месенджер чи лист. Якщо плану в угоді не було, Krokul заводить його сам зі строком, що дорівнює строку дії посилання.
Коли клієнт заплатив, monobank надсилає вебхук зі статусом success. Krokul перевіряє підпис X-Sign публічним ключем мерчанта, звіряє суму й валюту з планом і проводить оплату фактом датою з вебхука. Подія payment.received іде далі в облік чи командний чат, а коли рахунок угоди закрито повністю, один раз спрацьовує invoice.paid.
Для передоплати під замовлення гроші можна лише заблокувати. Вебхук зі статусом hold лишає оплату плановою, а коли товар готовий, менеджер натискає «Списати», і Krokul викликає invoice/finalize. Після вебхука success холд стає фактом.
Якщо клієнт відмовився, менеджер повертає оплату кнопкою в угоді. Krokul викликає invoice/cancel, а вебхук reversed записує повернення в стрічку й зменшує оплачене по угоді. Бухгалтеру не треба шукати платіж у кабінеті monobank.
Коли строк посилання минув або сума змінилась, менеджер створює нове. Krokul інвалідує попередній рахунок методом invoice/remove, а для посилань, що прострочились без вебхука, перевіряє invoice/status і позначає їх у плані оплат.
| monobank | Напрям | Krokul | Коли |
|---|---|---|---|
| Рахунок (invoice/create): сума в копійках, валюта, webHookUrl | Krokul → monobank | Планова оплата угоди | Менеджер натискає «Посилання на оплату» |
| invoiceId і pageUrl | monobank → Krokul | Посилання в блоці «Оплати» | У відповідь на створення рахунку |
| Вебхук success | monobank → Krokul | Оплата-факт, стрічка угоди, подія payment.received | Клієнт заплатив |
| Вебхук hold і invoice/finalize | monobank ↔ Krokul | Планова оплата, кнопка «Списати» | Кошти заблоковано; списання на вимогу менеджера |
| invoice/cancel і вебхук reversed | monobank ↔ Krokul | Повернення в угоді, запис у стрічці | Менеджер повертає оплату |
| invoice/remove | Krokul → monobank | Попереднє посилання планової оплати | Менеджер створює нове посилання |
| invoice/status | monobank → Krokul | Позначка протермінованого посилання | Після строку дії посилання |
Krokul нічого не проводить, відповідає помилкою й записує подію в журнал інтеграції. Так само Krokul відхиляє вебхук без підпису чи з підписом, який не зійшовся з публічним ключем.
Krokul передає в monobank гривні, долари, євро, злоті й фунти. Валюта береться з планової оплати або з угоди.
Hold означає, що кошти заблоковані на картці клієнта й ще чекають списання. Krokul показує їх плановою оплатою, доки менеджер не спише холд і monobank не надішле success.
Так. Кнопка повернення в угоді викликає скасування оплати в monobank, а вебхук reversed зменшує оплачене по угоді й лишає запис у стрічці.
Сторінка описує еквайринг monobank, тобто рахунки на оплату й платежі за ними. monobank не надсилає вебхук для протермінованого рахунку, тому стан такого посилання Krokul уточнює запитом статусу.
Напишіть, яким сервісом ви користуєтесь і що має ходити між ним і Krokul. Ми відповімо способом і строком.
Запит отримано. Відповімо на вашу пошту.
monobank є торговою маркою її власника. Krokul не афілійований із monobank.