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

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

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

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

Установка

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

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

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

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