Стандартний LiqPay в OpenCart вміє одне: відправити покупця на сторінку оплати і дочекатися відповіді. Цього вистачає, поки не з'являються живі задачі: взяти передоплату замість повної суми, заблокувати гроші на картці до перевірки складу, надіслати клієнту посилання на оплату вже після того, як менеджер уточнив замовлення, віддати в LiqPay дані для фіскального чека. Модуль «Liqpay API Opencart» від розробника bogdan281989 закриває саме ці сценарії, причому все керується з адмінки магазину.
У пакеті три пов'язані методи оплати: головний модуль, окремий метод «Передоплата» і копія головного модуля з власними ключами API для єПідтримки або будь-якого іншого акаунта LiqPay. Нижче пройдемося по екранах налаштувань і по тому, що з'являється в замовленнях.
Якщо ви ще обираєте платіжну систему, спершу гляньте наше порівняння модулів оплати карткою для OpenCart, а тут розберемо саме LiqPay детально.
Основні налаштування: ключі, тип платежу і схема роботи
Перша вкладка головного модуля. Тут підключається магазин LiqPay і вибирається, як саме покупець платитиме. Для тестів можна вставити sandbox-ключі з кабінету LiqPay, а після перевірки замінити їх бойовими.

- Публічний і приватний ключ. Беруться з кабінету LiqPay, без них метод не працюватиме.
- Тип платежу. Звичайне списання або блокування коштів на картці (двоетапна оплата, Hold): гроші резервуються, а списує їх менеджер після підтвердження.
- Схема роботи. Стандартна з переходом на liqpay.com або вбудований віджет на сторінці оформлення чи у спливаючому вікні, без переходу на зовнішній сайт.
- Мінімальна й максимальна сума. Метод показується лише для замовлень у заданому діапазоні. Поруч налаштовуються гео зони.
- Запис до логу. Модуль логує всі запити й відповіді платіжної системи. Лог переглядається на окремій вкладці, і це перше місце, куди варто дивитися, якщо оплата «зависла».
Статуси замовлення під кожну подію
Модуль не обмежується одним статусом «Оплачено». Під кожну подію платежу можна призначити свій статус замовлення, і менеджер одразу бачить у списку, на якому етапі гроші.

- Зміна статусу при переході до оплати. Можна змінювати статус ще до оплати, щоб бачити замовлення, де покупець пішов платити, але не завершив.
- Статус оплаченого замовлення. Ставиться після успішного платежу. Нижче окремо задається статус для скасованих.
- Статус після генерації посилання. Для замовлень, яким менеджер вручну згенерував посилання на оплату з адмінки.
- Статус після відхилення платежу. Разом зі статусом після прийняття стосується двоетапної оплати: що буде із замовленням, коли менеджер прийняв або повернув кошти.
Додаткові параметри: валюта, мова і способи оплати
На вкладці «Додаткове» зібрано те, що впливає на сторінку оплати, яку бачить покупець. За замовчуванням модуль сам визначає валюту й мову, але все можна задати вручну.

- Валюта оплати. Автоматично за валютою замовлення або фіксована.
- Мова сторінки оплати. Автовизначення або ручний вибір.
- Варіанти оплати. Беруться з налаштувань акаунта LiqPay або задаються вручну: картка, Apple Pay, Google Pay, кабінет LiqPay чи Приват24, рахунок на e-mail, QR-код, Masterpass.
- Форсувати перехід до оплати. Окремий перемикач для поведінки переходу на оплату після підтвердження замовлення.
- Назва методу для кошика. Можна перевизначити, як метод підписаний на оформленні, окремо для кожної мови магазину.
Передоплата: фіксована сума або відсоток
Окремий метод оплати для часткової передоплати. Він працює лише разом із головним модулем і бере ключі з нього. Сценарій звичний для магазинів з доставкою післяплатою: покупець оплачує частину онлайн, решту при отриманні.

- Нижня межа. Мінімальна сума замовлення, з якої пропонується передоплата.
- Тип нарахування суми. Фіксована сума або відсоток від суми покупки.
- Відсоток. Розмір передоплати, на скріні 10%.
- Назва способу оплати. Задається для кожної мови, наприклад «Передоплата 200 грн LiqPay», щоб покупець одразу бачив, скільки платить зараз.
Третій метод пакета, копія для єПідтримки, налаштовується так само, як головний, але з окремими ключами API. Його можна використати й для будь-якого іншого акаунта LiqPay.
Посилання на оплату з картки замовлення
У картці замовлення з'являється кнопка «Liqpay» з меню. Звідти менеджер генерує інвойс: посилання на оплату, яке можна надіслати клієнту листом прямо з адмінки. Зручно, коли замовлення прийшло по телефону або склад змінився і суму треба перерахувати.

- Дані інвойсу. Номер замовлення, контакти покупця, мова і валюта підтягуються із замовлення.
- Товари інвойсу. Позиції можна редагувати, додавати й видаляти перед відправкою.
- Відправка. Покупець отримує посилання на оплату. Для посилання задається таймер дії у хвилинах.
Двоетапна оплата: прийняти або повернути
Якщо в основних налаштуваннях обрано блокування коштів, гроші покупця резервуються на картці, а рішення приймає менеджер. Інформацію про транзакцію модуль бере з API LiqPay просто в картці замовлення.

- Меню «Liqpay» у замовленні. Перегляд транзакції цього замовлення і отримання посилання на оплату.
- Тип і статус платежу. Видно, що оплата двоетапна і гроші зарезервовані в очікуванні підтвердження.
- Списання і рішення. Сума до списання і кнопки «Прийняти платіж» та «Повернути гроші».
Це корисно, коли товар треба спершу знайти на складі або в постачальника: не доведеться робити повернення за вже списані гроші.
Журнал транзакцій
У меню «Продажі» з'являється розділ «Транзакції Liqpay». Тут усі платежі в одному списку, без входу в кабінет LiqPay.

- Фільтри. За номером замовлення, номером платежу LiqPay, статусом, сумою і датами створення та закриття транзакції.
- Статус платежу. Очікує прийняття, невдала оплата, гроші повернуто клієнту: видно одразу, без переходу в кабінет.
- Деталі. Кнопка перегляду відкриває повну інформацію про транзакцію.
Товари для фіскалізації
Модуль передає в LiqPay дані товарів для формування фіскальних чеків. Для цього є розділ «Товари Liqpay», де товари магазину зв'язуються з товарами в кабінеті LiqPay. У налаштуваннях задається мова чека і поле, яке йде як артикул (model, sku, ean, isbn тощо).

- Керування списком. Додати товар вручну, завантажити список або видалити позиції.
- Фільтри. Пошук за ID товару в LiqPay і кодом товару в магазині.
- Відповідність кодів. Зв'язка ID товару в LiqPay з кодом товару в магазині, назвою, ціною і штрихкодом.
Що врахувати перед покупкою
- Потрібен ionCube Loader. Перед покупкою перевірте, що він увімкнений на хостингу для вашої версії PHP.
- Активація через офіційний сайт доповнення, ліцензія на один домен. Модуль звертається до сервера розробника, але за характеристиками продовжує працювати, якщо той недоступний.
- За характеристиками модуль працює на OpenCart 2.0.3–3.0.5 і 4.1.0, а також на ocStore 2.x і 3.x. PHP від 5.6 до 8.2.
- Скріни зроблені на ocStore 3.0.3.7, актуальна версія модуля на момент огляду 2.3.0. Перевіряти оновлення можна прямо з адмінки.
- Розробник заявляє повну сумісність із шаблонами OCTemplates і модулем Smart Checkout. Якщо у вас інший нестандартний чекаут, особливо з вбудованим віджетом, уточніть сумісність у розробника.
- Фіскальні чеки формує LiqPay з даних товарів, які передає модуль. Як фіскалізація підключається на боці LiqPay, варто уточнити в платіжної системи до запуску.
Кому підійде
Магазинам, які вже працюють з LiqPay і хочуть більше, ніж просто кнопку оплати: передоплату під доставку, двоетапну оплату під товар під замовлення, посилання на оплату для телефонних замовлень, журнал транзакцій в адмінці і фіскальні чеки. Окремо стане в пригоді тим, хто приймає оплату за єПідтримкою на окремий акаунт.
Якщо вам вистачає звичайної оплати карткою без передоплат і ручної роботи із замовленнями, а хостинг без ionCube, можливо, простішого рішення буде достатньо. Порівняти варіанти можна в огляді платіжних модулів, посилання на який є на початку статті.
«Liqpay API Opencart» від bogdan281989 на маркетплейсі OpenCart Code. Питання щодо налаштування можна поставити розробнику прямо на сторінці модуля.