# VitaliiHura Checkout for LiqPay

> Написав і випустив у каталозі WordPress.org свій безкоштовний плагін, через який магазин на WooCommerce приймає оплату через LiqPay: карткою, Apple Pay, Google Pay і Приват24. Після оплати замовлення саме стає оплаченим, а якщо сповіщення LiqPay загубилося, плагін сам звіряє статус. Зробив увесь шлях: код і автотести, повернення із замовлення, перевірку командою каталогу та запуск у живому магазині.

Кейс · Плагін WordPress: https://vitaliihura.com/uk/work/checkout-for-liqpay

- Автор: [Віталій Гура](https://vitaliihura.com/uk), фулстек-розробник
- Роль: Розробник плагіна WordPress
- Стек: PHP, WordPress, WooCommerce, JavaScript, LiqPay API, PHPUnit
- Терміни: 2 тижні
- Рік: 2026
- Клієнт: Власний продукт
- Сайт: https://wordpress.org/plugins/vitaliihura-checkout-for-liqpay/
- Код: https://github.com/vitaliihura/vitaliihura-checkout-for-liqpay-pb

## Задача

LiqPay від ПриватБанку обирають багато українських магазинів, але готові модулі до WooCommerce нерідко підводять саме там, де це коштує грошей. На одному з проєктів безкоштовний модуль не приймав від LiqPay підтвердження оплати, ця функція була лише в платній версії. Оплачені замовлення висіли в очікуванні й через якийсь час скасовувалися самі. Магазину Vydna потрібна була оплата, якій можна довіряти і яка працює з новою сторінкою оформлення замовлення. Я написав свій плагін і виклав його безкоштовно, щоб ним міг користуватися будь-який магазин.

## Що зроблено

- **Замовлення закривається автоматично.** Після оплати LiqPay надсилає магазину сповіщення. Плагін звіряє його підпис із секретним ключем магазину, тож підробити оплату не вийде, і одразу позначає замовлення оплаченим. Повторне сповіщення не змінює замовлення вдруге.
- **Якщо сповіщення загубилося.** Коли покупець повертається в магазин після оплати, плагін сам запитує в LiqPay статус платежу. Якщо покупець закрив вкладку, щогодини відбувається звірка неоплачених замовлень, а в картці замовлення є кнопка оновлення статусу.
- **Гроші лише на своє замовлення.** Оплата зараховується, лише якщо збігаються валюта й сума замовлення, а тестовий платіж не може закрити справжнє замовлення. Ці випадки й розбір номера замовлення з будь-яким префіксом перевіряють автотести.
- **Повернення просто із замовлення.** Повне або часткове повернення робиться кнопкою в замовленні WooCommerce, без входу в кабінет LiqPay. У замовленні видно, скільки списали, яку комісію взяв LiqPay і скільки повернули покупцеві.
- **Нове й старе оформлення.** Плагін працює і з блоковою сторінкою оформлення замовлення, яка стоїть у нових магазинах за замовчуванням, і з класичною. Тестовий режим можна відкрити лише менеджерам і перевірити оплату на живому магазині так, що покупці цього не побачать.
- **Кілька мов.** Назву способу оплати, опис і призначення платежу задають для кожної мови сайту. Мова береться із замовлення, тож покупець з англійської версії побачить англійський рядок і у виписці за карткою. Працює з Polylang, WPML і TranslatePress.
- **Приватність і каталог.** На запит покупця про видалення особистих даних плагін стирає із замовлення частково прихований номер картки й банк. Перед публікацією плагін пройшов перевірку каталогу WordPress.org та офіційну автоматичну перевірку без зауважень.

## Результат

Плагін опублікований у каталозі WordPress.org, його вже завантажили понад 240 разів, і він безкоштовно ставиться з адмінки будь-якого магазину на WooCommerce. У магазині Vydna він приймає оплату на робочому домені, а закриття замовлення перевірено справжнім платежем. За тією самою схемою готую плагіни для monobank і WayForPay. Плагін незалежний, LiqPay і ПриватБанк його не випускали.

## Як виглядає сайт

- Екран налаштувань: Налаштування розбито на розділи, а вгорі одразу видно, чого бракує для приймання оплати. ![Екран налаштувань плагіна в адмінці WordPress із розділами та підказкою вгорі](https://vitaliihura.com/storage/cases/checkout-for-liqpay-settings.jpg?v=1793979743)
- Параметри оплати: Магазин обирає способи оплати на сторінці LiqPay, її мову й призначення платежу для кожної мови сайту. ![Параметри оплати зі способами оплати LiqPay, мовою сторінки та призначенням платежу за мовами](https://vitaliihura.com/storage/cases/checkout-for-liqpay-payment.jpg?v=1793979743)
- Сторінка в каталозі: На сторінці плагіна пояснено, що буде, якщо покупець оплатив, а замовлення залишилося в очікуванні. ![Сторінка плагіна в каталозі WordPress.org](https://vitaliihura.com/storage/cases/checkout-for-liqpay-faq.jpg?v=1793979743)

Зробити схожий проєкт: https://vitaliihura.com/uk/quote
