> ## Knowledge Base Index > Fetch the complete knowledge base index at: https://help.dilovod.ua/sitemap.xml > Use this file to discover available pages before exploring further. > Pure-Markdown content can be obtained by appending a '.md' suffix to the content URLs listed in the sitemap (without the trailing slash). # Оплата за QR-кодом Monobank ###### Інтеграція з Monobank у системі Dilovod дозволяє: * отримувати готове посилання на оплату * додавати QR-код у друковані форми для швидкої оплати * контролювати статус оплати рахунку (оплачено, до сплати, скасовано тощо) --- # 1. Підключення ###### 1.1 Отримання тестового токена Monobank Для отримання токена виконайте наступні кроки: 1. Для цього перейдіть за адресою [https://api.monobank.ua](https://api.monobank.ua/index.html) ![](https://storage.crisp.chat/users/helpdesk/website/-/e/d/9/3/ed939352f97ce800/2026-04-0710-02_ptxq2m.png =1050x732) 2. Відскануйте QR код для входу за допомогою застосунку Monobank на Вашому смартфоні. Або натисніть на код, якщо виконуєте дії на телефоні. 3. На екрані смартфона натисніть **Підтвердити** ![](https://storage.crisp.chat/users/helpdesk/website/-/e/d/9/3/ed939352f97ce800/2026-04-0710-30_ywlpzc.png =1050x943) 4. Після цього на сторінці https://api.monobank.ua клікніть команду **Активувати токен** для підключення токена. ![](https://storage.crisp.chat/users/helpdesk/website/-/e/d/9/3/ed939352f97ce800/2026-04-0710-14_1trmm47.png =1050x357) 5. Скопіюйте вміст поля. ![](https://storage.crisp.chat/users/helpdesk/website/-/e/d/9/3/ed939352f97ce800/2026-04-0710-15_wwdhnc.png =1050x358) **Особливості тестового режиму** * не потребує підключення інтернет-еквайрингу * не потребує створення терміналу * якщо у вас в оплаті відображається **Test Caption** — це означає, що використовується тестовий токен ![](https://storage.crisp.chat/users/helpdesk/website/-/e/d/9/3/ed939352f97ce800/2026-04-0810-09_biqc47.png =1050x479) ###### **1.2. Отримання бойового API токена** Для отримання токена виконайте наступні кроки: 1. Перейдіть у бізнес-кабінет Monobank: [https://web.monobank.ua](https://web.monobank.ua/) 2. У лівому меню оберіть **Термінали**. Оберіть потрібний термінал (якщо у вас один — він буде єдиний доступний) || "Термінал" — це інтернет-еквайринг для прийому оплат онлайн. Навіть якщо ви: надаєте послуги, не маєте магазину, не маєте фізичного термінала — у вас все одно створюється віртуальний термінал для прийому оплат через: QR, інвойси, сайт, посилання на оплату 3. Натисніть команду **Інтеграції**, далі — **Створити токен** 4. Збережіть згенерований токен для подальшого використання **ВАЖЛИВО!** * токен прив’язується до конкретного терміналу * один термінал = один токен * назва терміналу буде відображатись клієнту при оплаті ###### Якщо у вас немає розділу Термінали Це означає, що у вас не підключений інтернет-еквайринг. У такому випадку необхідно: * Звернутися в підтримку Monobank * Подати запит на підключення інтернет-еквайрингу --- # 2. Налаштування інтеграції в базі даних Для налаштування інтеграції виконайте такі кроки: ###### Налаштувань обліку ► Структура ► Підприємці ►відкриваємо карту підприємця ► Інтеграції ► Monobank оплата по QR-коду у вікні що відкрилося необхідно натиснути команду **Додати нове підключення** ![](https://storage.crisp.chat/users/helpdesk/website/-/e/d/9/3/ed939352f97ce800/2026-04-0722-17_1thhfwy.png =1050x467) **Налаштування підключення:** * вкажіть особистий токен 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. ![](https://storage.crisp.chat/users/helpdesk/website/-/e/d/9/3/ed939352f97ce800/2026-04-0722-38_4z79q4.png =1050x469) --- # 3. Публікація рахунку Для публікації рахунку виконайте наступні кроки: * Перейдіть у розділ Продажі ► Замовлення покупця *(або оберіть будь-який інший документ, який був доданий у налаштуваннях інтеграції)* * Створіть новий документ або відкрийте вже існуючий * У відкритому документі натисніть кнопку **Публікація рахунку Monobank** ![](https://storage.crisp.chat/users/helpdesk/website/-/e/d/9/3/ed939352f97ce800/2026-04-0722-46_g8z02v.png =1050x467) Після натискання кнопки відкривається вікно публікації рахунку. У ньому потрібно заповнити або перевірити такі поля: * **Призначення платежу** - заповнюється автоматично (наприклад: дата та номер документа). За потреби текст можна змінити — це поле буде відображатися клієнту при оплаті. * **Сплатити до** - вкажіть дату та час, до якого рахунок має бути оплачений. Якщо поле не заповнювати: буде використано значення з поля «сплатити до» у документі або якщо і там дата не вказана — рахунок діятиме 1 рік * **Email платника** - необов’язкове поле. Можна вказати email клієнта для додаткової ідентифікації або комунікації. Після заповнення полів натисніть кнопку **Публікувати рахунок**. ![](https://storage.crisp.chat/users/helpdesk/website/-/e/d/9/3/ed939352f97ce800/2026-04-0722-50_f4ulkn.png =1050x470) Після успішної публікації: * створюється активне посилання на оплату * кнопка Monobank у документі відображає актуальний статус рахунку ![](https://storage.crisp.chat/users/helpdesk/website/-/e/d/9/3/ed939352f97ce800/2026-04-0722-51_17x0cl6.png =1050x468) Рахунок може мати такі статуси: * **Неактивний** — рахунок не опублікований * **До сплати** — рахунок успішно створений * **Термін сплати сплив** — якщо оплата не була здійснена у встановлений час. Повний перелік можливих статусів доступний у документації API Monobank: [https://api.monobank.ua/docs/acquiring.html](https://api.monobank.ua/docs/acquiring.html) --- # 4. Відміна рахунку Для відміни рахунку: * Натисніть на кнопку **Monobank** зі статусом "До сплати" у документі * У відкритому вікні натисніть **Відмінити рахунок** ![](https://storage.crisp.chat/users/helpdesk/website/-/e/d/9/3/ed939352f97ce800/2026-04-0722-53_125vw48.png =1050x471) Після цього: * посилання на оплату стає недійсним * статус рахунку змінюється на "Неактивний" * у повя'заних документах рахунок отримує статус "Скасовано" ![](https://storage.crisp.chat/users/helpdesk/website/-/e/d/9/3/ed939352f97ce800/2026-04-0723-12_upaxiq.png =1050x471) --- # 5. Додавання QR-коду в друковану форму Після створення рахунку можна додати QR-код для переходу на сторінку оплати. **Як додати QR-код:** * У документі натисніть **Друк** * Оберіть Рахунок покупцеві ► Налаштування ► Редагувати шаблон ![](https://storage.crisp.chat/users/helpdesk/website/-/e/d/9/3/ed939352f97ce800/2026-04-0723-23_b5ebk5.png =1050x469) * Відкриється форма редагування шаблону * Далі натисніть команду **Додати QR-код** * Клікніть по QR-коду правою кнопкою миші * Оберіть **Властивості** ![](https://storage.crisp.chat/users/helpdesk/website/-/e/d/9/3/ed939352f97ce800/2026-04-0722-561_mmfhjh.png =1050x469) * У полі значення вкажіть: **urlForPaymentOfInvoice** * Натисніть **Застосувати** ![](https://storage.crisp.chat/users/helpdesk/website/-/e/d/9/3/ed939352f97ce800/2026-04-0722-57_blmkhz.png =1050x466) **В результаті:** * QR-код буде додано до друкованої форми * При скануванні користувач переходить на сторінку оплати рахунку ![](https://storage.crisp.chat/users/helpdesk/website/-/e/d/9/3/ed939352f97ce800/2026-04-0723-21_1qx1f5q.png =1050x466) --- # 6. Оплата рахунку Користувач може здійснити оплату одним із способів: 1. перейти за прямим посиланням на рахунок 2. або відсканувати QR-код, розміщений у друкованій формі Після цього: * відкривається сторінка оплати Monobank * користувач обирає спосіб оплати (наприклад, через мобільний додаток або карткою) * підтверджує платіж ![](https://storage.crisp.chat/users/helpdesk/website/-/e/d/9/3/ed939352f97ce800/2026-04-0723-05_pf3l0k.png =1050x650) Після оплати: * статус рахунку в системі змінюється на "Успішна оплата" * кошти зараховуються згідно з обраним типом операції (миттєво або після підтвердження у випадку hold) Якщо рахунок вже оплачено при повторному переході за посиланням або QR-кодом Monobank відобразить повідомлення про помилку ![](https://storage.crisp.chat/users/helpdesk/website/-/e/d/9/3/ed939352f97ce800/2026-04-0723-09_1oarq5e.png =1050x432)