Стандартный 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. Вопросы по настройке можно задать разработчику прямо на странице модуля.