Install
This is the repository archive. It installs, but the folder name will carry the branch suffix and updates will not flow.
Install straight from GitHub with WP-CLI:
wp plugin install https://github.com/kodzhesyan/ukrpay-woo/archive/refs/heads/main.zipUkrPay WooCommerce Gateway
Приймайте платежі на розрахунковий рахунок (IBAN) за стандартами НБУ. Генерація QR-кодів для Monobank, Privat24 та інших банківських застосунків.
📋 Опис
UkrPay — це рішення для WooCommerce, яке дозволяє автоматизувати прийом платежів на банківський рахунок (IBAN) в Україні. Плагін генерує динамічний QR-код згідно зі специфікаціями Національного банку України. Клієнту достатньо відсканувати код у своєму банківському додатку, і всі реквізити (IBAN, ЄДРПОУ, сума, призначення платежу) підтягнуться автоматично.
Це ідеальна альтернатива еквайрингу для тих, хто хоче приймати прямі платежі на рахунок ФОП або ТОВ без зайвих комісій посередників.
✨ Основні можливості
QR-код стандарту НБУ: Повна сумісність з популярними банками (Monobank, ПриватБанк, А-Банк, ПУМБ тощо).
Deep-link оплата: Кнопка "Сплатити в додатку" для мобільних користувачів (відкриває банківський додаток автоматично).
Адаптивний дизайн:
На десктопі: красива картка з QR-кодом та реквізитами.
На мобільному: компактний вигляд, QR-код приховується для зручності, залишається кнопка оплати.
Валідація даних: Вбудована перевірка формату IBAN (UA + 29 символів) в адмін-панелі для запобігання помилкам.
Стилізація: Сучасний "повітряний" дизайн платіжної картки та кнопка оплати у стилі Amazon.
Брендування: Можливість додати власний логотип (іконку) банку або компанії, який адаптується під чекаут.
Інтеграція з Email: Реквізити та QR-код автоматично додаються у лист "Замовлення отримано" для клієнта.
Автоматизація: При виборі цього методу замовлення отримує статус "На утриманні" (On Hold), а складські запаси зменшуються.
⚙️ Встановлення
Завантажте файл плагіну у папку /wp-content/plugins/ на вашому сервері або встановіть через адмін-панель WordPress (Плагіни > Додати новий > Завантажити плагін).
Активуйте плагін через меню "Плагіни" в WordPress.
Перейдіть до WooCommerce > Налаштування > Платежі.
Увімкніть метод "Оплата на IBAN" та перейдіть до його налаштувань (кнопка "Керувати").
🔧 Налаштування
Для коректної роботи заповніть наступні поля в налаштуваннях плагіну:
Увімкнути/Вимкнути: Активує шлюз на сторінці оформлення замовлення.
Назва методу: Те, що бачить клієнт (наприклад, "Оплата на IBAN").
Логотип (URL): Посилання на зображення (рекомендована висота 25-30px).
Опис: Коротка інструкція для клієнта.
Отримувач: Назва вашої організації (ФОП або ТОВ).
IBAN Рахунок: Ваш номер рахунку у форматі UA... (обов'язково 29 символів).
ЄДРПОУ / ІПН: Ваш податковий номер.
Важливо: Платіжний метод з'явиться на сторінці оплати тільки якщо валюта вашого магазину встановлена як Українська гривня (UAH).
📱 Відображення на пристроях
Desktop: Відображається QR-код, реквізити текстом та кнопка швидкої оплати.
Mobile (<768px): QR-код та допоміжні тексти приховуються для економії місця. Відображається кнопка "Сплатити в додатку" та текстові реквізити IBAN.