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

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), а также полные и частичные возвраты прямо из админки.

Что получает админ

Как это работает — шаг за шагом

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) автоматически, когда вы переводите заказ в «Выполнен». Возврат — полный или частичный — делается из карточки заказа.

Что включено в лицензии

Сколько стоит

890 грн — лицензия на год. Год обновлений, технической поддержки и доступа ко всем Pro-функциям. Без автосписаний: продление всегда вручную, реквизиты карты мы не храним.

Можно сразу взять более длинный срок — чем он длиннее, тем дешевле за год:

• 1 год — 890 грн
• 2 года — 1 690 грн (−5%, по 845 грн за год)
• 3 года — 2 350 грн (−12%, по 783 грн за год)
• 4 года — 2 920 грн (−18%, по 730 грн за год)
• 5 лет — 3 340 грн (−25%, по 668 грн за год)

Когда срок истекает, останавливаются только обновления и новые функции, а 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 или ПриватБанком.

История версий

1.1.1 — вебхук LiqPay и возврат покупателя больше не проводят оплату дважды: раньше они приходили в одну миллисекунду, оба видели «ещё не оплачено», и в заказе появлялись две оплаты и двойное списание остатка; на магазинах с HPOS от этого не спасало даже перечитывание заказа. Возврат покупателя больше не показывает «Оплата не завершена» на заказе, который вебхук только что оплатил. Время последней проверки лицензии пишется в UTC.

1.1.0 — пробный период Pro на 7 дней по клику: ключ приходит на e-mail, карта не нужна, и больше ничего не включается само собой при установке. Лицензия теперь проверяется на сервере CatCode (раньше Pro открывала любая непустая строка в поле ключа), а если наш сервер недоступен — Pro держится ещё 14 дней. Pro-возможности видны на своих местах: режим AUTH и журнал платежей помечены Pro с пояснением, что они дают; журнал больше не исчезает из меню без лицензии. Ключ не затирается обычным «Сохранить изменения».