База знань

Як підключити Plata by Mono до магазину

Команда OKKKI · 2 хв читання · оновлено 13 червня 2026 р.

Plata by Mono — це інтернет-еквайринг Monobank, який дозволяє приймати оплату карткою прямо в Telegram-магазині. Для підключення потрібен ФОП і кабінет на web.monobank.ua. Налаштування займає 10-15 хвилин і робиться один раз.

Що потрібно перед підключенням#

  • ФОП з відкритим розрахунковим рахунком у Monobank. Якщо ФОП ще не оформлений — це окреме питання до вашого бухгалтера, OKKKi цю частину не закриває.

  • Кабінет інтернет-еквайрингу на web.monobank.ua — зареєструватися і пройти верифікацію (це окрема процедура від звичайного Monobank і робиться до налаштувань у OKKKi).

  • Доступ до кабінету OKKKi як власник магазину.

Якщо ФОП тільки оформлюється — на цей час увімкніть базові способи: «Переказ на картку», «Готівкою при отриманні», «Картка при отриманні». Вони активні за замовчуванням і не потребують жодних інтеграцій. Plata by Mono додасте пізніше, коли інтернет-еквайринг буде готовий.

Покрокова інструкція#

  1. Перейдіть у Налаштування Магазину → вкладка Оплата (okkki.net/shop-settings?tab=payment). У ряду з WayForPay і LiqPay знайдіть тайл «Monobank» — за замовчуванням він неактивний.

  2. У кабінеті Monobank відкрийте розділ API і створіть X-Token для вашого сайту. Скопіюйте його.

  3. У полі «Webhook URL» в кабінеті Monobank вставте адресу, яку OKKKi генерує автоматично у форматі https://okkki.net/api/webhooks/payments/monobank?shop_id={ID_магазину}. Підпис вебхука перевіряється через публічний ключ Monobank, окремо налаштовувати нічого не треба.

  4. Поверніться в OKKKi, натисніть на тайл «Monobank» — відкриється модалка «Підключити Monobank». Заповніть поля, які попросить система (X-Token обов'язковий + інші реквізити з кабінету Monobank, якщо модалка їх запитає).

  5. Введіть «Назва в боті» — як клієнт побачить цей спосіб оплати (наприклад, «Plata by Mono» або «Карткою онлайн»). Увімкніть чекбокс активності і натисніть «Зберегти».

Як перевірити що працює#

Зробіть тестове замовлення від імені клієнта в боті вашого магазину. Оберіть будь-який товар або послугу з невеликою сумою — на кроці оплати має з'явитися кнопка з назвою, яку ви вказали в полі «Назва в боті». Після натискання відкриється платіжна сторінка Monobank.

Сплатіть невелику суму своєю карткою. Замовлення в кабінеті OKKKi має автоматично перейти у статус «Оплачено». Якщо статус оновився — інтеграція працює. Гроші можна повернути собі через кабінет Monobank.

Якщо щось пішло не так#

  • Тайл «Monobank» неактивний навіть після збереження — перевірте чекбокс активності в модалці і ще раз натисніть «Зберегти».

  • Кнопка оплати не з'являється у боті — переконайтеся, що в полі «Назва в боті» немає порожнього значення. Без назви спосіб не показується клієнту.

  • Платіж пройшов, але статус замовлення не оновився — у кабінеті Monobank перевірте, що Webhook URL вставлений повністю, разом із ?shop_id=.... Це найчастіша помилка.

  • Помилка авторизації X-Token — згенеруйте новий токен у Monobank API і замініть його в OKKKi.

Якщо помилка не з цього списку — напишіть менеджеру @manager_okkki з номером замовлення і скріншотом помилки.

Пов'язані матеріали#

Стаття допомогла?