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

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