LiqPay — оплата картой для OpenCart 2.3, 3.x и 4.x

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

Базовая версия — бесплатная. Скачать: liqpay.ocmod.zip (OpenCart 4.x) или liqpay-oc3.ocmod.zip (OpenCart 3.x). В Free — приём оплаты картой и автоподтверждение заказа вебхуком; Pro добавляет журнал платежей со сверкой статусов, двухэтапную оплату (AUTH + SETTLE) и полные и частичные возвраты прямо из админки.

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

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

1. Покупатель на чекауте выбирает «Оплата картой (LiqPay)» и подтверждает заказ.
2. Модуль формирует подписанный запрос и перенаправляет покупателя на защищённую страницу оплаты LiqPay — карта, Apple Pay или Google Pay. Данные карты вводятся на стороне LiqPay и в ваш магазин не попадают.
3. После оплаты LiqPay шлёт serviceUrl-вебхук на роут extension/liqpay/payment/liqpay.callback. Модуль проверяет HMAC-MD5-подпись по сырому телу запроса и ставит заказу выбранный статус «оплачено».
4. Когда покупатель возвращается в магазин, статус дополнительно сверяется через Status API — заказ завершается только если транзакция действительно успешна.
5. С Pro: при двухэтапной схеме средства только блокируются (AUTH), а списываются (SETTLE) автоматически, когда вы переводите заказ в статус «оплачено». Возврат — полный или частичный — делается из журнала платежей.

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

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

1 490 грн — разовая покупка. Лицензия бессрочная: платите один раз, обновления и техническая поддержка входят в цену. Один ключ — один домен и его поддомены.

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

Лицензия бессрочная — ничего не истекает и не выключается. Один ключ — один домен; переносите магазин — деактивируйте лицензию на старом домене и активируйте на новом самостоятельно.

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

Сначала триал, потом оплата. Свежая установка — это бесплатная версия: Pro сам не включается и ничего не гаснет через неделю. Когда захотите посмотреть Pro — нажмите «Попробовать Pro» в настройках модуля, укажите email и получите ключ на 7 дней (он же придёт письмом). Так что журнал транзакций, AUTH/SETTLE и возвраты вы проверяете на собственном магазине ещё до покупки — именно поэтому возврат средств после оплаты не предусмотрен.

Установка

1. Админка → Расширения → Установка расширений → загрузите liqpay.ocmod.zip и нажмите «Установить».
2. Админка → Расширения → Оплата → найдите LiqPay и нажмите «+» (это создаёт таблицу модуля, событие и права доступа).
3. Нажмите «Редактировать»: включите модуль, впишите ключи из кабинета LiqPay. Для теста оставьте «Тестовый режим» и впишите пару ключей с префиксом sandbox_.
4. URL вебхука прописывать в кабинете LiqPay не нужно — модуль передаёт его при каждом платеже.

Технические требования

• OpenCart 3.0.2 – 3.0.5.0 (сборка liqpay-oc3.ocmod.zip) или 4.0.2 – 4.1.x (сборка liqpay.ocmod.zip)
• PHP 7.4+
• Публичный и приватный ключ LiqPay — из кабинета LiqPay; для тестов нужна отдельная пара ключей sandbox_

Что под капотом

• Подпись проверяется по сырому телу запроса — OpenCart html-экранирует POST, поэтому вебхук читает `php://input` напрямую, иначе подпись не совпадала бы.
• Двойная проверка оплаты: подписанный вебхук плюс сверка через Status API при возврате покупателя.
• Идемпотентность — повторный вебхук не меняет статус второй раз и не понижает уже подтверждённый заказ.
• Приватный ключ шифруется ключом, производным от пути магазина и имени БД — скопированные настройки на другом сайте не расшифруются.

LiqPay — торговая марка АО КБ «ПриватБанк». Этот модуль является независимой интеграцией и не аффилирован с LiqPay или ПриватБанком.

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

1.0.4 — 2 августа 2026

Исправлена недоплата: колбэк на сумму, меньшую заказа, больше не сохраняется как успешная оплата — заказ остаётся неоплаченным с пометкой о недоплате, а следующий колбэк на полную сумму корректно переводит его в «Оплачено». Лицензия переживает недоступность catcode.com.ua: сетевая ошибка больше не считается ответом «ключ недействителен», поэтому Pro не гаснет во время сбоя (14-дневный льготный период наконец работает). Частичные возвраты в журнале считаются накопительно — сумма остатка теперь правильная после нескольких возвратов. Триал стартует только вашим кликом, свежая установка — чистая бесплатная версия.

1.0.1 — 23 июля 2026

Исправлен конфликт при оформлении заказа на OpenCart 4.0.2.x: проверка гео-зоны больше не загружает отсутствующую в этой версии каталога модель и не блокирует выбор способа оплаты.

1.0.0 — июль 2026

Первый публичный релиз.