WordPress

LiqPay — оплата карткою для WooCommerce

Приймання оплати карткою Visa/Mastercard, Apple Pay та Google Pay через LiqPay у WooCommerce. Автопідтвердження замовлення serviceUrl-вебхуком з перевіркою HMAC-MD5-підпису. Pro — журнал платежів, двоетапна оплата і повернення з адмінки.

Версія
v1.0.1
Сумісність
WooCommerce 7.0+ · WordPress 6.2+
Платформа
WordPress
LiqPay — оплата карткою для WooCommerce

Що всередині

  • Оплата карткою Visa/Mastercard через захищену сторінку LiqPay
  • Apple Pay і Google Pay без окремого налаштування
  • Автопідтвердження замовлення підписаним serviceUrl-вебхуком
  • Перевірка HMAC-MD5-підпису — статус змінюється тільки за реальною оплатою
  • Підтримка блокового та класичного чекауту WooCommerce
  • Сумісність з HPOS (нове зберігання замовлень WooCommerce)
  • Журнал платежів зі звіркою статусів Pro
  • Двоетапна оплата: AUTH + SETTLE (блокування суми) Pro
  • Повні та часткові повернення прямо з адмінки Pro
  • Сумісність з WooCommerce 7.0+ і WordPress 6.2+

LiqPay для WooCommerce — платіжний плагін, який приймає оплату карткою Visa/Mastercard, Apple Pay і Google Pay через захищену сторінку LiqPay. Покупець оплачує — LiqPay надсилає підписаний serviceUrl-вебхук, плагін перевіряє HMAC-MD5-підпис і сам переводить замовлення у потрібний статус. Жодної ручної звірки «оплачено чи ні» — замовлення підтверджується лише тоді, коли гроші реально пройшли.

Базова версія — безкоштовна. Завантажити: catcode-card-payments-with-liqpay-for-woocommerce.zip. У Free — приймання оплати карткою і автопідтвердження замовлення вебхуком; Pro додає журнал платежів зі звіркою статусів, двоетапну оплату (AUTH + SETTLE) та повні й часткові повернення прямо з адмінки.

Що отримує адмін

LiqPay — налаштування шлюзу у WooCommerce
Одна сторінка налаштувань у WooCommerce → Платежі: тестовий режим, бойові й sandbox-ключі, тип платежу (одно- чи двоетапний), статус замовлення після оплати, готовий URL вебхука.
LiqPay — журнал платежів у WooCommerce
Журнал платежів (Pro): статус у LiqPay і у WooCommerce поруч, сума, маскована картка, номер транзакції. Звірка статусу — кнопкою з цього ж екрана.

Як це працює — крок за кроком

  1. Покупець на чекауті обирає «Оплата карткою (LiqPay)» і оформлює замовлення. Працює і класичний, і блоковий (Gutenberg) чекаут.
  2. Плагін формує підписаний запит і перенаправляє покупця на захищену сторінку оплати LiqPay — картка, Apple Pay або Google Pay. Дані картки вводяться на боці LiqPay і на ваш сайт не потрапляють.
  3. Після оплати LiqPay шле serviceUrl-вебхук на REST-маршрут catcode-liqpay/v1/webhook. Плагін перевіряє HMAC-MD5-підпис і ставить замовленню статус «В обробці» або «Виконано».
  4. Коли покупець повертається на сайт, статус додатково звіряється через Status API — замовлення завершується тільки якщо транзакція справді успішна.
  5. З Pro: при двоетапній схемі кошти лише блокуються (AUTH), а списуються (SETTLE) автоматично, коли ви переводите замовлення у «Виконано». Повернення — повне чи часткове — робиться з картки замовлення.

Що включено в ліцензії

Функція Безкоштовно Pro
Оплата Visa/Mastercard, Apple Pay, Google Pay через сторінку LiqPay
Автопідтвердження замовлення serviceUrl-вебхуком з перевіркою HMAC-MD5-підпису
Звірка статусу транзакції при поверненні покупця (Status API)
Тестовий режим на sandbox-ключах — повний тестовий платіж до підписання договору
Класичний і блоковий чекаут, HPOS-сумісність
Валюти UAH, USD, EUR
Логування у стандартний лог WooCommerce
Журнал платежів — статус, сума, маскована картка, номер транзакції; ручна звірка з журналу
Двоетапна оплата — AUTH-блокування коштів і SETTLE-списання при виконанні замовлення
Повернення коштів — повні та часткові, прямо з картки замовлення

Скільки коштує

1 990 грн — ліцензія на рік. Рік оновлень, технічної підтримки та доступу до всіх Pro-функцій. Без автосписань: продовження завжди вручну, реквізити картки ми не зберігаємо.

Можна одразу взяти довший термін — що довший, то дешевше за рік:

  • 1 рік — 1 990 грн
  • 2 роки — 3 780 грн (−5%, по 1 890 грн за рік)
  • 3 роки — 5 250 грн (−12%, по 1 750 грн за рік)
  • 4 роки — 6 530 грн (−18%, по 1 630 грн за рік)
  • 5 років — 7 460 грн (−25%, по 1 490 грн за рік)

Коли термін спливає, вимикаються лише Pro-функції — безкоштовна версія працює далі, налаштування і дані нікуди не діваються. Щоб знову відкрити Pro, достатньо продовжити ліцензію в особистому кабінеті. Нагадаємо на пошту за 14, 7, 3 і 1 день до завершення.

Один ключ — один домен. Переносите магазин — деактивуйте ліцензію на старому домені й активуйте на новому самостійно, без звернення до підтримки.

Спершу тріал, потім оплата. Одразу після встановлення вмикається 7-денний безкоштовний Pro-тріал: журнал операцій, двоетапну оплату і повернення можна перевірити на власному магазині ще до покупки. Саме тому повернення коштів після оплати не передбачене — ви бачите модуль у справі до того, як платите.

Технічні вимоги

  • WooCommerce 7.0+ (класичний і блоковий чекаут, HPOS)
  • WordPress 6.2+
  • PHP 7.4+
  • Публічний і приватний ключ LiqPay — з кабінету LiqPay; для тестів потрібна окрема пара ключів з префіксом sandbox_

Що під капотом

  • Підпис перевіряється до розбору даних — вебхук звіряє HMAC-MD5 по сирому рядку, тож підроблений запит не доходить до замовлення.
  • Подвійна перевірка оплати: підписаний serviceUrl-вебхук плюс звірка через Status API на поверненні покупця — статус не зміниться від підробленого запиту.
  • Ідемпотентність — повторний вебхук по вже оплаченому замовленню не створює дублів і не змінює статус удруге.
  • serviceUrl передається автоматично при кожному платежі — у кабінеті LiqPay нічого вручну прописувати не треба.

LiqPay — торгова марка АТ КБ «ПриватБанк». Цей плагін є незалежною інтеграцією і не афілійований з LiqPay чи ПриватБанком.

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

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

Public і private ключі з кабінету LiqPay. Вставляєте їх у налаштування плагіна, вмикаєте спосіб оплати — і приймання платежів працює.

Замовлення підтверджується автоматично?

Так. LiqPay надсилає підписаний serviceUrl-вебхук, плагін перевіряє HMAC-MD5-підпис і переводить замовлення в потрібний статус лише тоді, коли гроші реально пройшли.

Чи можна тестувати без реальних грошей?

Так, LiqPay має sandbox-режим із тестовими ключами. Врахуйте: sandbox-транзакції LiqPay не дозволяє повертати, тож повернення перевіряються вже на бойовому мерчанті.

Чим Pro відрізняється від безкоштовної версії?

Free приймає оплату і автоматично підтверджує замовлення. Pro додає журнал платежів зі звіркою, двоетапну оплату (блокування суми з подальшим списанням) і повернення з адмінки.

Чи працює з блоковим чекаутом?

Так, підтримуються і блоковий, і класичний чекаут.

Ви пов'язані з LiqPay або ПриватБанком?

Ні. Це незалежний плагін CatCode, який використовує публічний API LiqPay. Ми не афілійовані з LiqPay чи ПриватБанком.

Питання щодо модуля?

Пишіть у Telegram — відповімо протягом робочого дня. Допоможемо з налаштуванням, сумісністю та активацією ключа.

@catcode_support

Не той варіант, що шукаєте?

Ми робимо кастомні модулі під WordPress, WooCommerce, OpenCart і Shopify. Розкажіть про задачу — підготуємо оцінку.

Замовити кастомний модуль