Гроші проводить Monobank — CRM не торкається карток і нічого не списує. Її роль інша й не менш важлива: почути від банку, що конкретний рахунок оплачено, і поставити цей факт на конкретне замовлення так, щоб менеджер побачив його без відкривання кабінету еквайрингу. Кожне підтвердження перевіряється криптографічним підписом, тому підроблене «оплачено» не пройде. Повторна доставка того самого вебхука не створить другої оплати.
Як це працює
Підписаний вебхук
Monobank надсилає статус рахунку із заголовком x-sign. CRM читає сире тіло запиту й перевіряє ECDSA-підпис публічним ключем вашого мерчанта — інакше не приймає нічого.
Оплата на замовленні
Створюється запис оплати з сумою, валютою, методом і статусом, прив’язаний до замовлення за reference рахунку.
Статус замовлення
Замовлення переходить у «Підтверджено», якщо воно ще «Очікує» і сума оплат покриває суму замовлення.
Сповіщення команді
Успішна оплата дає один дзвіночок і push власнику й менеджерам — рівно один, навіть якщо банк повторив доставку.
Журнал оплат
Усі оплати всіх провайдерів — в одному списку з пошуком, фільтрами й станом прив’язки. Видно, за що заплатили, навіть якщо замовлення ще немає.
Частковий рахунок видно
Рахунок показує похідний стан: не оплачено, частково або оплачено — на основі суми фактичних оплат у валюті замовлення.
Межі відповідальності
Що саме робить CRM, а що лишається за Monobank і вашим магазином. Ці межі важливі: платіжна інтеграція, яка обіцяє більше, ніж робить, — найдорожчий вид непорозуміння.
- CRM приймає
- підписані status-webhook-и рахунку; статус expired Monobank через webhook не надсилає, тож його відстежує та сторона, яка створила рахунок
- CRM записує
- id рахунку, статус, фактичну суму й валюту; reference рахунку → externalId замовлення
- CRM може змінити
- «Очікує» → «Підтверджено» лише для успішної оплати, що покриває замовлення у правильній валюті
- CRM створює
- рахунок на оплату, коли менеджер тисне «Посилання на оплату» на замовленні чи рахунку — сторінку оплати хостить Monobank, посилання діє добу
- CRM не виконує
- скасування рахунків, повернення коштів, split-платежі, списання чи зберігання даних картки
- Валюти
- Гривня, а також долар і євро — валюта береться з числового коду ISO-4217 у вебхуці, суми переводяться з копійок
Оплата, яка не знайшла замовлення, не губиться
Найчастіша проблема платіжних інтеграцій: гроші прийшли, а система не знає, до чого їх причепити — і просто відкидає подію.
- Якщо reference рахунку не збігається з жодним замовленням, оплата все одно зберігається — у журналі «Комерція → Оплати» зі станом «не прив’язано».
- Менеджер відкриває таку оплату й або прив’язує її до наявного замовлення, або створює з неї нове — з покупцем і сумою, які вже відомі.
- З картки замовлення діє й зворотний шлях: вибрати наявну неприв’язану оплату зі списку.
- Оплату можна зареєструвати вручну — для готівки або переказу, які взагалі не проходили через еквайринг.
- Повторна доставка того самого вебхука не створює дубля: запис ідемпотентний за id рахунку.
Перевірка акаунта — діагностика, а не бар’єр
Callback працює одразу після збереження токена мерчанта: коректно підписана подія від Monobank сама себе автентифікує, тому вимагати «спершу пройдіть тест» було б зайвою перешкодою між вами й реальною оплатою. За бажанням перевірка з’єднання зробить безпечне читання й покаже, до якого акаунта належить токен, нічого не змінюючи в CRM.
Налаштування
- 1
Додайте адаптер Monobank
Вкажіть токен мерчанта з кабінету Monobank Acquiring. Адреса для вебхуків з’явиться на сторінці створеного адаптера. Токен зберігається зашифрованим.
- 2
Передавайте адресу у webHookUrl
Ваш магазин додає цю адресу в поле webHookUrl кожного запиту на створення рахунку — глобального вебхука мерчанта офіційний API не описує. У merchantPaymInfo.reference передавайте externalId замовлення з CRM: саме за ним оплата знайде своє замовлення.
- 3
Перевірте на реальній оплаті
Проведіть один справжній платіж. Оплата має з’явитися в журналі й на замовленні, а команда — отримати сповіщення.
Часті запитання
Як підключити Monobank до CRM?
Додайте адаптер Monobank у Налаштуваннях → Інтеграції, вставте токен мерчанта з кабінету еквайрингу й скопіюйте адресу для вебхуків. Далі ваш магазин передає цю адресу в полі webHookUrl при створенні рахунку — і оплати починають з’являтися в CRM.
Чи потрібен окремий тест перед прийомом реальних оплат?
Ні. Підписана подія від Monobank автентифікує себе сама, тому вебхуки приймаються одразу після збереження токена. Перевірка з’єднання доступна як діагностика, але не є умовою.
Чи зберігає CRM дані картки?
Ні. Номер картки й CVV не надходять у CRM і не зберігаються. Зберігаються лише сума, валюта, статус і id рахунку — того достатньо, щоб звірити оплату із замовленням.
Як CRM знаходить правильне замовлення?
За полем reference рахунку: ваш магазин передає в ньому externalId замовлення, і CRM шукає замовлення саме з цим ідентифікатором у вашому просторі. Знайти замовлення іншого простору вебхук не може.
Що буде, якщо reference не збігся?
Оплата не пропадає. Вона зберігається в журналі оплат зі станом «не прив’язано», і менеджер прив’язує її до наявного замовлення або створює з неї нове.
Чи створює CRM рахунки або повертає кошти?
Рахунок — так, коли ви самі про це просите: кнопка «Посилання на оплату» на замовленні чи рахунку виставляє рахунок Monobank і повертає посилання, яке менеджер надсилає покупцю. Повернення коштів, скасування рахунків і будь-які списання лишаються на боці Monobank і вашого магазину — CRM їх не робить.
Чи можна так само приймати оплати інших провайдерів?
Так. LiqPay, WayForPay і Hutko підключаються тим самим шляхом і пишуть у той самий журнал оплат — кожен зі своєю схемою перевірки підпису, як вимагає офіційна документація провайдера.
Що підключають разом
LiqPay
БетаПлатіж, підтверджений LiqPay, дає одне сповіщення команді й оновлює відповідне замовлення в CRM.
ДетальнішеWayForPay
ДоступноCRM перевіряє результат оплати, сповіщає команду та прив’язує платіж до наявного замовлення. Якщо збігу немає, оплата залишається у зрозумілому списку для звірки.
ДетальнішеHutko
ДоступноПісля кожної оплати CRM фіксує результат, сповіщає команду та прикріплює платіж до наявного замовлення або залишає його у зрозумілому списку для звірки.
ДетальнішеRozetka
БетаНайбільший маркетплейс України: замовлення приходять у CRM самі, товари з каталогу публікуються прайс-файлом, ціни й залишки повертаються в кабінет продавця, а питання покупців стають лідами з відповідальним менеджером.
ДетальнішеProm.ua
ДоступноЗамовлення, оплати й доставка приходять самі. Питання покупців стають лідами, і ви відповідаєте на них прямо з CRM, не відкриваючи кабінет Prom.
ДетальнішеБета: Бета-версія: підключення доступне вже сьогодні, можливості каналу ще доопрацьовуються.
Підключити Monobank
Оплати з еквайрингу самі стають на замовлення — а ті, що не знайшли своє, чекають у журналі, а не зникають.
Почати безкоштовно