LiqPay — оплата карткою для OpenCart 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 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-тріал: журнал операцій, двоетапну оплату і повернення можна перевірити на власному магазині ще до покупки. Саме тому повернення коштів після оплати не передбачене — ви бачите модуль у справі до того, як платите.

Встановлення

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 8.0+
• Публічний і приватний ключ LiqPay — з кабінету LiqPay; для тестів потрібна окрема пара ключів sandbox_

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

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

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

Історія версій

1.0.1 — 23 липня 2026

Виправлено конфлікт при оформленні замовлення на OpenCart 4.0.2.x: перевірка гео-зони більше не завантажує відсутню в цій версії каталогу модель і не блокує вибір способу оплати.

1.0.0 — липень 2026

Перший публічний реліз.