Як підключити Monobank для автоматичного підтвердження оплат

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

Перед початком

• Потрібен доступ до кабінету monobank на web.monobank.ua (для ФОП це бізнес-кабінет) і картка або рахунок, на який клієнти платитимуть.
• Токен дає доступ лише до читання виписки. Через нього неможливо переказати чи списати гроші.
• Одночасно активний лише один банк. Якщо раніше був обраний ПриватБанк, після збереження активним стане Monobank.

Як підключити

Подивіться, як це виглядає, у відео на 18 секунд: Як отримати токен Monobank і підключити його в sweetlo.io.

1. 01Відкрийте web.monobank.ua і увійдіть у кабінет. Натисніть на свій аватар у правому верхньому куті та оберіть "Мої токени".
2. 02У вікні "Мої токени" натисніть "Активувати токен". З'явиться повідомлення "Токен активовано".
3. 03Натисніть значок копіювання поруч із токеном. З'явиться повідомлення "Токен скопійовано". Банк дозволяє скопіювати токен лише один раз, одразу після активації. Токен діє безстроково, а на одну компанію можна активувати не більше 5 токенів.

Далі перейдіть до консолі. Відкрийте "Налаштування" > "Інтеграції банків".

4. 04У полі "Провайдер" оберіть "Monobank", вставте токен у поле "Monobank API токен" і натисніть "Зберегти".

Як перевірити

Після збереження з'явиться повідомлення "Налаштування інтеграцій банків збережено", а вгорі сторінки блок "Токен Monobank збережено." з написом "Monobank обрано активним банком."

Це підтверджує, що токен збережено, але не гарантує, що перша оплата пройде. Щоб переконатися, створіть тестове замовлення на невелику суму й сплатіть його, вказавши номер замовлення в коментарі до переказу. Замовлення має стати оплаченим автоматично.

Як консоль розпізнає оплату

• Консоль шукає номер замовлення в коментарі до платежу. Попросіть клієнтів вказувати його.
• Часткові оплати додаються одна до одної. Замовлення стає оплаченим, коли сума досягає вартості замовлення.
• Оплату за платіжним посиланням підтверджено автоматично лише за точного збігу суми. Якщо сума інша, підтвердьте оплату вручну.

Як змінити токен

Відкрийте "Налаштування" > "Інтеграції банків", вставте новий токен у те саме поле й натисніть "Оновити". Збережений токен у полі не показується.

Поширені запитання

Який токен потрібен?

Токен із розділу "Мої токени" в кабінеті monobank, який відкриває доступ до виписки. Токен для еквайрингу з розділу "Оплата на сайті" не підійде: це окремий токен для іншої послуги.

Форма пише "API-ключ Monobank має містити щонайменше 40 символів".

Токен скопійовано не повністю. Скопіюйте його ще раз без пробілів на початку й в кінці. Якщо не встигли скопіювати, активуйте новий токен у розділі "Мої токени".

З'явилося попередження "Webhook Monobank не вдалося зареєструвати автоматично".

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

Оплата є в банку, а замовлення не оплачене.

Перевірте, чи є номер замовлення в коментарі до переказу. Якщо сума менша за вартість замовлення, воно залишиться частково оплаченим.

Чи можна підключити обидва банки?

Ні. Активним буває один банк, його обирають у полі "Провайдер".