ГайдПочатковий

Як налаштувати оплату в магазині OKKKI

Оплата — це момент, коли клієнт ухвалює фінальне рішення. Якщо в магазині немає зручного способу заплатити, він піде до конкурента. У OKKKI закладено 6 способів прийому платежів — від простого переказу на картку до повноцінного інтернет-еквайрингу. Цей гайд про те, як обрати правильні методи під ваш бізнес і коректно їх підключити.


Де налаштовується оплата#

Усі методи оплати знаходяться в одному місці: Налаштування Магазину → Оплата. Це окремий таб в розділі налаштувань. Тут видно всі доступні способи, які з них увімкнені, і які потребують підключення.

Кожен спосіб оплати — це окрема картка з тоглом. Зеленим виділено активні методи, пунктиром — ті, що ще не підключені.

Image

6 способів оплати: огляд#

У OKKKI методи оплати діляться на дві групи:

Готові до використання одразу (без реєстрації):#

  1. Переказ на карту — клієнт переводить оплату на вашу картку або через СБП. Працює як інструкція в боті: бот надсилає номер картки, клієнт переказує сам, ви перевіряєте надходження вручну.

  2. Готівкою — оплата кур'єру або в пункті видачі. Підходить для локальної доставки і самовивозу.

  3. Карткою при отриманні — оплата через термінал у кур'єра або в пункті видачі. Працює, якщо у вас є POS-термінал або кур'єр з мобільним терміналом.

Інтернет-еквайринг (потребують реєстрації):#

  1. Monobank Acquiring — інтернет-еквайринг від Monobank. Кошти йдуть на ваш бізнес-рахунок Monobank через mono.online.

  2. LiqPay — інтернет-еквайринг від ПриватБанку. Приймає Visa, Mastercard, Apple Pay, Google Pay, Privat24. Кошти на ваш бізнес-рахунок у ПриватБанку.

  3. WayForPay — інтернет-еквайринг для українських магазинів. Visa, Mastercard, Apple Pay, Google Pay. Кошти на ваш рахунок WayForPay.

Окремо: криптовалюти

Якщо ваші клієнти платять у криптовалютах — OKKKI інтегрується з CryptoCloud. Це окремий модуль зі своєю логікою підключення. Детальний розбір — у Базі знань: Як приймати криптоплатежі через CryptoCloud.


Як підключити готові методи (5 хвилин)#

Перші 3 методи увімкнути просто:

Переказ на карту:#

  1. Увімкнути тогл навпроти методу

  2. Вказати номер картки (можна вказати лише останні 4 цифри, наприклад «•••7601»)

  3. Клієнт побачить інструкцію в боті при оформленні замовлення

Готівка і Картка при отриманні:#

  1. Увімкнути тогл

  2. Налаштовувати додатково нічого не треба

  3. Метод одразу з'являється при оформленні замовлення

Це базовий набір для більшості малого бізнесу. Якщо ви тільки запускаєтеся і ще не маєте ФОП — починайте з цих трьох. Вони не потребують жодної реєстрації, працюють миттєво.

Image

Як обрати між Monobank, LiqPay і WayForPay#

Інтернет-еквайринг приймає картки онлайн і списує кошти автоматично. Клієнт оплачує одразу, не потрібно перевіряти переказ вручну. Це професійний рівень для бізнесу, який обробляє багато замовлень на день.

Monobank Acquiring — підходить, якщо:#

  • У вас уже є бізнес-рахунок у Monobank

  • Ви хочете швидке підключення (Monobank — простіший для верифікації)

  • Працюєте з невеликим оборотом

  • Хочете отримувати кошти на mono.online

LiqPay — підходить, якщо:#

  • У вас рахунок у ПриватБанку (бізнес-картка)

  • Хочете додати Privat24 як спосіб оплати

  • Працюєте з більшим оборотом і середнім чеком

  • Потрібна підтримка Apple Pay і Google Pay

WayForPay — підходить, якщо:#

  • У вас зареєстрований домен (потрібен Merchant Domain)

  • Хочете найбільший вибір способів оплати (понад 20 методів)

  • Працюєте з різними банками, не лише ПриватБанком чи Monobank

  • Готові пройти трохи довшу верифікацію

Загальне правило: не потрібно підключати всі 3 одразу. Оберіть один інтернет-еквайринг під ваш банк і обслуговуйте його. Решту додасте, якщо побачите, що клієнти просять.


Що потрібно для підключення інтернет-еквайрингу#

Для всіх 3 методів схема однакова: ви реєструєтесь у платіжній системі, отримуєте API-ключі, вставляєте їх у OKKKI.

Загальні вимоги:#

  • Юридична особа або ФОП. Інтернет-еквайринг без оформлення підприємницької діяльності не працює.

  • Український банківський рахунок для отримання коштів.

  • Верифікація бізнесу в платіжній системі (зазвичай 1-3 дні).

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

Підключення LiqPay — як виглядає#

  1. Зареєструйте бізнес у LiqPay через ПриватБанк

  2. У кабінеті LiqPay перейдіть «Налаштування» → «API»

  3. Скопіюйте Public Key і Private Key

  4. У OKKKI відкрийте картку LiqPay і натисніть «Підключити»

  5. Вставте ключі у форму

  6. Скопіюйте Server URL (callback) з OKKKI і вставте в кабінеті LiqPay у відповідне поле

  7. Збережіть і протестуйте оплату

Server URL виглядає так: https://okkki.net/api/webhooks/payments/liqpay?shop_id=X (де X — номер вашого магазину).

Підключення WayForPay — нюанс з доменом#

WayForPay вимагає Merchant Domain — це домен, на якому розташований ваш магазин. Оскільки OKKKI — це Telegram-магазин, а не сайт, при реєстрації вкажіть будь-який ваш домен (можна купити простий за 200 грн/рік) або зверніться в підтримку WayForPay — вони підкажуть, що вказати для Telegram-WebApp.

Підключення Monobank Acquiring#

Найшвидший шлях, якщо у вас уже є бізнес-картка Monobank:

  1. Зайдіть у застосунок Monobank, відкрийте розділ «Acquiring»

  2. Активуйте інтернет-еквайринг (займає 1-2 дні на верифікацію)

  3. Отримайте токен mono.online

  4. У OKKKI натисніть «Підключити» на картці Monobank Acquiring

  5. Вставте токен і збережіть

Покрокові інструкції з фінальними налаштуваннями — у Базі знань: окремі статті по кожному провайдеру.


Який набір способів оплати обрати#

Універсальний набір для більшості малих бізнесів:

Мінімум (старт без ФОП):#

  • ✅ Переказ на карту

  • ✅ Готівкою (якщо є доставка кур'єром або самовивіз)

  • ❌ Інтернет-еквайринг — пізніше

Стандартний набір (з ФОП):#

  • ✅ Переказ на карту

  • ✅ Готівкою / Карткою при отриманні

  • ✅ Один інтернет-еквайринг (LiqPay або Monobank)

Розширений набір (середній і великий оборот):#

  • ✅ Переказ на карту

  • ✅ Готівкою / Карткою при отриманні

  • ✅ LiqPay (для Privat24 і карток)

  • ✅ WayForPay (для альтернатив, рідкісних карток)

Більше 4 методів — клієнт губиться у виборі. Не варто.


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

Після підключення обов'язково зробіть тестове замовлення від імені клієнта:

  1. Відкрийте магазин з іншого Telegram-акаунту

  2. Додайте товар у кошик з мінімальною ціною (наприклад, 1 грн)

  3. Оформіть замовлення, обираючи кожен підключений метод оплати

  4. Перевірте, що бот коректно показує інструкцію або редиректить на сторінку платіжної системи

  5. Для еквайрингу — пройдіть тестовий платіж (LiqPay має sandbox-режим з тестовими ключами)

  6. Переконайтеся, що замовлення з'являється у кабінеті в розділі «Замовлення»

Тестовому замовленню присвятимо окремий гайд.


Що робити далі#

Способи оплати налаштовано. Наступний крок — налаштувати доставку: Нова Пошта, кур'єр, самовивіз. Без зрозумілих варіантів доставки клієнт не оформить замовлення.


Якщо щось не працює#

Проблема

Що перевірити

Метод оплати не з'являється у клієнта

Перевірити, чи увімкнено тогл навпроти методу

LiqPay показує помилку при оплаті

Перевірити, чи правильно скопійовані Public/Private Key, чи вказаний Server URL у кабінеті LiqPay

WayForPay не приймає підключення

Перевірити Merchant Domain — він має точно збігатися з тим, що зареєстрований у WayForPay

Monobank Acquiring не активується

Перевірити статус верифікації бізнесу в застосунку Monobank, може потребувати 1-3 дні

Кошти не зараховуються після оплати

Перевірити Server URL і налаштування webhook у кабінеті платіжки

Хочу прийняти криптовалюту

Окрема стаття в Базі знань про CryptoCloud


Корисні матеріали#

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