# monobank + Krokul CRM

Так. Krokul CRM підключається до інтернет-еквайрингу monobank (Plata by mono) без коду. Менеджер створює посилання на оплату з угоди, клієнт платить на платіжній сторінці, а вебхук monobank переводить планову оплату у факт і перераховує оплачене по угоді.

**Статус:** Нативна.

## Що отримує команда

### Посилання на оплату з блоку «Оплати»

Менеджер натискає «Посилання на оплату» в угоді. Krokul створює в monobank рахунок методом invoice/create на суму планової оплати й показує pageUrl, який можна надіслати клієнту в месенджер чи лист. Якщо плану в угоді не було, Krokul заводить його сам зі строком, що дорівнює строку дії посилання.

### Вебхук success проводить оплату сам

Коли клієнт заплатив, 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 | Оплата-факт, стрічка угоди, подія `payment.received` | monobank → Krokul | Клієнт заплатив |
| Вебхук hold і invoice/finalize | Планова оплата, кнопка «Списати» | monobank ↔ Krokul | Кошти заблоковано; списання на вимогу менеджера |
| invoice/cancel і вебхук reversed | Повернення в угоді, запис у стрічці | monobank ↔ Krokul | Менеджер повертає оплату |
| invoice/remove | Попереднє посилання планової оплати | Krokul → monobank | Менеджер створює нове посилання |
| invoice/status | Позначка протермінованого посилання | monobank → Krokul | Після строку дії посилання |

## Як підключити сьогодні

### Підключення (нативно, без коду)

1. У кабінеті monobank відкрийте «Еквайринг» → «Налаштування» і скопіюйте токен API.
2. Отримайте публічний ключ для перевірки підпису: запит GET https://api.monobank.ua/api/merchant/pubkey із заголовком X-Token повертає поле key.
3. У Krokul відкрийте «Маркетплейс» → «Plata by mono» і заповніть токен API, публічний ключ колбека й публічну адресу Krokul. За бажанням вкажіть сторінку, куди повернути клієнта після оплати.
4. Адресу вебхука в кабінеті monobank вводити не потрібно: Krokul передає її в кожному рахунку сам.
5. Створіть посилання з угоди й перевірте оплату. Відповіді й відмови monobank видно в журналі інтеграції.

### Для інтеграторів

Посилання створюється й через роут публічного API Krokul `payment/api-link` з `cardUuid` і `amount` або з `uuid` наявної планової оплати, а виклик з `probe: true` лише відповідає, чи готовий провайдер. Подію `payment.received` слухайте підписаним вебхуком Krokul (HMAC-SHA256) з журналом і повторною доставкою. Номер рахунку monobank зручно тримати зовнішнім ключем `externalRef` поруч з угодою.

[Документація API](https://app.krokul.com/api/v1/docs)

## Питання й відповіді

### Що буде, якщо сума у вебхуку monobank не збігається з оплатою в угоді?

Krokul нічого не проводить, відповідає помилкою й записує подію в журнал інтеграції. Так само Krokul відхиляє вебхук без підпису чи з підписом, який не зійшовся з публічним ключем.

### У яких валютах можна виставити посилання monobank?

Krokul передає в monobank гривні, долари, євро, злоті й фунти. Валюта береться з планової оплати або з угоди.

### Чому оплата зі статусом hold не стала фактом?

Hold означає, що кошти заблоковані на картці клієнта й ще чекають списання. Krokul показує їх плановою оплатою, доки менеджер не спише холд і monobank не надішле success.

### Чи можна повернути оплату monobank із Krokul?

Так. Кнопка повернення в угоді викликає скасування оплати в monobank, а вебхук reversed зменшує оплачене по угоді й лишає запис у стрічці.

## Обмеження

Сторінка описує еквайринг monobank, тобто рахунки на оплату й платежі за ними. monobank не надсилає вебхук для протермінованого рахунку, тому стан такого посилання Krokul уточнює запитом статусу.

## Пов’язані сервіси

- [NovaPay](https://krokul.com/uk/integrations/novapay/index.md)
- [LiqPay](https://krokul.com/uk/integrations/liqpay/index.md)
- [WayForPay](https://krokul.com/uk/integrations/wayforpay/index.md)
- [ПриватБанк](https://krokul.com/uk/integrations/privatbank/index.md)
- [Checkbox](https://krokul.com/uk/integrations/checkbox/index.md)

[Платежі й банки (Україна)](https://krokul.com/uk/integrations/category/payments-ua/index.md)

monobank є торговою маркою її власника. Krokul не афілійований із monobank.

Оновлено: 2026-10-12

---

Застосунок: https://app.krokul.com/ · API: https://app.krokul.com/api/v1/docs