Статті на: Інтеграції

Оплата за QR-кодом Monobank

Інтеграція з Monobank у системі Dilovod дозволяє:
  • отримувати готове посилання на оплату
  • додавати QR-код у друковані форми для швидкої оплати
  • контролювати статус оплати рахунку (оплачено, до сплати, скасовано тощо)



1. Підключення


1.1 Отримання тестового токена Monobank


Для отримання токена виконайте наступні кроки:

  1. Для цього перейдіть за адресою https://api.monobank.ua



  1. Відскануйте QR код для входу за допомогою застосунку Monobank на Вашому смартфоні. Або натисніть на код, якщо виконуєте дії на телефоні.
  2. На екрані смартфона натисніть Підтвердити



  1. Після цього на сторінці https://api.monobank.ua клікніть команду Активувати токен для підключення токена.



  1. Скопіюйте вміст поля.



Особливості тестового режиму

  • не потребує підключення інтернет-еквайрингу
  • не потребує створення терміналу
  • якщо у вас в оплаті відображається Test Caption — це означає, що використовується тестовий токен




1.2. Отримання бойового API токена


Для отримання токена виконайте наступні кроки:


  1. Перейдіть у бізнес-кабінет Monobank: https://web.monobank.ua
  2. У лівому меню оберіть Термінали. Оберіть потрібний термінал (якщо у вас один — він буде єдиний доступний)
"Термінал" — це інтернет-еквайринг для прийому оплат онлайн. Навіть якщо ви: надаєте послуги, не маєте магазину, не маєте фізичного термінала — у вас все одно створюється віртуальний термінал для прийому оплат через: QR, інвойси, сайт, посилання на оплату
  1. Натисніть команду Інтеграції, далі — Створити токен
  2. Збережіть згенерований токен для подальшого використання


ВАЖЛИВО!

  • токен прив’язується до конкретного терміналу
  • один термінал = один токен
  • назва терміналу буде відображатись клієнту при оплаті


Якщо у вас немає розділу Термінали


Це означає, що у вас не підключений інтернет-еквайринг. У такому випадку необхідно:

  • Звернутися в підтримку Monobank
  • Подати запит на підключення інтернет-еквайрингу



2. Налаштування інтеграції в базі даних


Для налаштування інтеграції виконайте такі кроки:

Налаштувань обліку ► Структура ► Підприємці ►відкриваємо карту підприємця ► Інтеграції ► Monobank оплата по QR-коду


у вікні що відкрилося необхідно натиснути команду Додати нове підключення



Налаштування підключення:

  • вкажіть особистий токен Monobank (1)
  • призначення платежу (2)


Додатково можна заповнити параметри зворотного зв'язку та обрати режим списання коштів:

  • Адреса для повернення (GET) (3): Укажіть URL-адресу сторінки вашого сайту, на яку клієнт буде перенаправлений після завершення транзакції (наприклад, сторінка «Дякуємо за замовлення»).
  • Адреса для CallBack / Webhook (POST) (4): Технічна адреса вашого сервера, на яку платіжна система надішле сповіщення про результат операції.


Також є можливість обрати стандартне миттєве списання або скористатися функцією відкладеного платежу - режим Заморозка коштів (hold) (5). Для значення hold термін становить 9 днів. При цьому типі оплати кошти не списуються одразу з картки, а блокуються на картці платника. Якщо протягом 9 днів холд не буде фіналізовано — він автоматично скасовується.


Monobank може автоматично фіскалізувати отриману оплату за рахунком. Для цього в тіло запиту на створення рахунку потрібно додати такі дані:

  • qrId - Ідентифікатор QR-каси для встановлення суми оплати на існуючих QR-касах
  • code string - Код терміналу субмерчанта, з апі "Список субмерчантів". Доступний обмеженому колу мерчантів, які точно знають, що їм це потрібно


Таблична частина зі ставками ПДВ та ставками з продажів (6) використовується для формування коду податкової ставки, який передається при створенні рахунку.

Якщо у користувача налаштовані ставки (є хоча б одна ставка), то при публікації платежу виконується перевірка наявності відповідної ставки в документі. Якщо таку ставку не знайдено — буде отримано нотифікацію. Якщо ставки не налаштовані (відсутні), платіж публікується без їх використання.


У блоці Показувати в документах (7) необхідно відмітити прапорцями ті типи документів, у яких ви плануєте використовувати оплату через Monobank. Після налаштування інтеграції у вибраних документах з’явиться кнопка Monobank.



3. Публікація рахунку


Для публікації рахунку виконайте наступні кроки:

  • Перейдіть у розділ Продажі ► Замовлення покупця (або оберіть будь-який інший документ, який був доданий у налаштуваннях інтеграції)
  • Створіть новий документ або відкрийте вже існуючий
  • У відкритому документі натисніть кнопку Публікація рахунку Monobank



Після натискання кнопки відкривається вікно публікації рахунку. У ньому потрібно заповнити або перевірити такі поля:

  • Призначення платежу - заповнюється автоматично (наприклад: дата та номер документа). За потреби текст можна змінити — це поле буде відображатися клієнту при оплаті.
  • Сплатити до - вкажіть дату та час, до якого рахунок має бути оплачений. Якщо поле не заповнювати: буде використано значення з поля «сплатити до» у документі або якщо і там дата не вказана — рахунок діятиме 1 рік
  • Email платника - необов’язкове поле. Можна вказати email клієнта для додаткової ідентифікації або комунікації.

Після заповнення полів натисніть кнопку Публікувати рахунок.



Після успішної публікації:

  • створюється активне посилання на оплату
  • кнопка Monobank у документі відображає актуальний статус рахунку



Рахунок може мати такі статуси:

  • Неактивний — рахунок не опублікований
  • До сплати — рахунок успішно створений
  • Термін сплати сплив — якщо оплата не була здійснена у встановлений час.

Повний перелік можливих статусів доступний у документації API Monobank: https://api.monobank.ua/docs/acquiring.html


4. Відміна рахунку


Для відміни рахунку:

  • Натисніть на кнопку Monobank зі статусом "До сплати" у документі
  • У відкритому вікні натисніть Відмінити рахунок



Після цього:

  • посилання на оплату стає недійсним
  • статус рахунку змінюється на "Неактивний"
  • у повя'заних документах рахунок отримує статус "Скасовано"



5. Додавання QR-коду в друковану форму


Після створення рахунку можна додати QR-код для переходу на сторінку оплати.

Як додати QR-код:

  • У документі натисніть Друк
  • Оберіть Рахунок покупцеві ► Налаштування ► Редагувати шаблон



  • Відкриється форма редагування шаблону
  • Далі натисніть команду Додати QR-код
  • Клікніть по QR-коду правою кнопкою миші
  • Оберіть Властивості



  • У полі значення вкажіть: urlForPaymentOfInvoice
  • Натисніть Застосувати



В результаті:

  • QR-код буде додано до друкованої форми
  • При скануванні користувач переходить на сторінку оплати рахунку



6. Оплата рахунку


Користувач може здійснити оплату одним із способів:


  1. перейти за прямим посиланням на рахунок
  2. або відсканувати QR-код, розміщений у друкованій формі

Після цього:

  • відкривається сторінка оплати Monobank
  • користувач обирає спосіб оплати (наприклад, через мобільний додаток або карткою)
  • підтверджує платіж



Після оплати:

  • статус рахунку в системі змінюється на "Успішна оплата"
  • кошти зараховуються згідно з обраним типом операції (миттєво або після підтвердження у випадку hold)

Якщо рахунок вже оплачено при повторному переході за посиланням або QR-кодом Monobank відобразить повідомлення про помилку



Оновлено: 08/04/2026

Чи була ця стаття корисною?

Поділіться своїм відгуком

Скасувати

Дякуємо!