QR::UA для WooCommerce: плагін оплати за стандартом НБУ

Огляд плагіна QR-оплати для WooCommerce

Плагін QR-оплати для WooCommerce — це повноцінний платіжний шлюз (Payment Gateway), який дозволяє вашому інтернет-магазину на WordPress приймати оплату через QR-код за стандартом НБУ (постанова №97). Покупці сканують QR-код або натискають на нього на мобільному, і оплата відбувається як звичайний банківський переказ за IBAN — без комісій еквайрингу.

Плагін інтегрується у стандартну архітектуру WooCommerce Payment Gateways. Це означає, що він з'являється у списку способів оплати на сторінці оформлення замовлення поряд з іншими платіжними методами та повністю керується через адмін-панель WordPress.

Ключові переваги

Технічні характеристики

Як працює оплата для покупця

Покупець на вашому WooCommerce-магазині бачить QR-оплату як один зі способів оплати при оформленні замовлення. Весь процес займає кілька секунд:

1. Вибір способу оплати. На сторінці Checkout покупець обирає «QR::UA» серед доступних платіжних методів.
2. Генерація QR-коду. Після підтвердження замовлення (кнопка «Оформити замовлення») покупець потрапляє на сторінку «Thank You» / «Order Received», де відображається QR-код з реквізитами платежу.
3. Оплата через банк. На мобільному пристрої — покупець натискає на QR-код (він клікабельний), і відкривається банківський застосунок. На комп'ютері — сканує QR камерою телефона.
4. Підтвердження. У банківському застосунку вже заповнені IBAN отримувача, сума та призначення платежу (номер замовлення). Покупець підтверджує переказ.
5. Автоматичне оновлення статусу. Плагін перевіряє банківську виписку кожні 10 хвилин та автоматично змінює статус замовлення на «Processing» (Обробляється) або «Completed» (Завершено).

Інтеграція з WordPress/WooCommerce

Плагін побудований на стандартній архітектурі WooCommerce Payment Gateways і використовує офіційні хуки та фільтри WordPress. Це забезпечує:

• Сумісність з темами. Плагін працює з будь-якою WooCommerce-сумісною темою, включаючи Storefront, Astra, GeneratePress, Flavor та інші.
• Сумісність з плагінами. Не конфліктує з іншими платіжними шлюзами, плагінами кешування, SEO-плагінами та іншими розширеннями WordPress.
• HPOS-сумісність. Підтримує новий High-Performance Order Storage (HPOS) у WooCommerce 8.x+, який замінює зберігання замовлень у wp_posts на окремі таблиці.
• Block Checkout. Працює з новим блоковим Checkout (Cart та Checkout blocks), який WooCommerce впроваджує як заміну класичного shortcode-based checkout.
• Мультимовність. Інтерфейс плагіна перекладений українською. Сумісний з WPML та Polylang для мультимовних магазинів.

Крок 1: Встановлення плагіна

Крок 2: Налаштування платіжного шлюзу

Крок 3: Тестування

Після налаштування обов'язково проведіть тестову оплату:

1. Оформіть тестове замовлення у вашому магазині
2. Оберіть «QR::UA» як спосіб оплати
3. Переконайтеся, що QR-код коректно відображається на сторінці Order Received
4. Проскануйте QR камерою телефона — повинен відкритися банківський застосунок
5. Здійсніть реальний переказ на мінімальну суму
6. Дочекайтеся автозвірки та перевірте зміну статусу замовлення

Автозвірка банківських виписок

Автозвірка — це механізм, який автоматично визначає, що покупець оплатив замовлення, і змінює статус замовлення у WooCommerce. Плагін працює з двома банками:

monobank. Плагін використовує відкритий API monobank для отримання виписки за останній період. Для підключення потрібен персональний або корпоративний API-токен, який можна отримати на api.monobank.ua.

ПриватБанк. Плагін використовує API Privat24 для бізнесу для перевірки надходжень на розрахунковий рахунок. Потрібні ключі доступу від API, які надає банк.

Алгоритм автозвірки:

1. WP-Cron запускає перевірку кожні 10 хвилин
2. Плагін отримує виписку з банку за API
3. Для кожного нового надходження плагін шукає відповідне замовлення за сумою та номером замовлення у призначенні платежу
4. Якщо відповідність знайдена — статус замовлення автоматично змінюється
5. Менеджер отримує стандартне WooCommerce-повідомлення про зміну статусу

Порівняння з іншими платіжними шлюзами

WooCommerce пропонує багато платіжних шлюзів для українського ринку. Ось як QR-оплата порівнюється з популярними альтернативами:

• LiqPay. Комісія 2.75% + щомісячна абонплата. Підтримує картки Visa/Mastercard. QR-оплата: 0% комісії, але працює лише з банківськими переказами.
• WayForPay. Комісія від 2%. Широкий функціонал (рекурентні платежі, marketplace). QR-оплата простіша, але безкоштовна.
• Fondy. Комісія від 2.45%. Зручний checkout. QR-оплата не має красивого checkout-віджета, але компенсує це нульовою комісією.
• Monobank Acquiring. Комісія від 1,3%. Швидке підключення. Але навіть 1,3% на великих обсягах — це суттєва сума.

Оптимальна стратегія — пропонувати QR-оплату як основний метод та один з класичних шлюзів як додатковий. Більшість покупців оберуть QR (економія для вас), а решта зможуть оплатити карткою. Детальне порівняння: QR::UA vs еквайринг.

Часті запитання

Чи сумісний плагін з Elementor / Gutenberg?

Так. Плагін працює на рівні WooCommerce Payment Gateway API і не залежить від візуального редактора сторінок. QR-код відображається на стандартній сторінці Order Received.

Чи працює з WooCommerce Subscriptions?

Ні. QR-оплата — це одноразовий банківський переказ, який не підтримує автоматичні рекурентні списання. Для підписок використовуйте класичний еквайринг.

Чи потрібен SSL-сертифікат?

SSL рекомендується для будь-якого інтернет-магазину, але QR-оплата не передає конфіденційних даних (як номери карток), тому технічно може працювати без SSL. Втім, WooCommerce та Google рекомендують HTTPS для всіх сайтів.

Чи потрібен ПРРО?

Ні. Банківські перекази за IBAN не потребують фіскалізації через ПРРО/РРО. Докладніше: Оплата за IBAN через QR-код.