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

Mono Acquiring для OpenCart 4 — платёжный модуль, который добавляет в магазин оплату картой через эквайринг monobank. Модуль создаёт счёт через API банка, отправляет покупателя на защищённую платёжную страницу monobank, а после оплаты принимает вебхук, сверяет его ECDSA-подпись и сам меняет статус заказа. Администратору не надо вручную проверять, кто оплатил — статусы в OpenCart обновляются автоматически.

Базовая версия — бесплатная. Скачать с официального OpenCart marketplace: opencart.com/…/extension_id=48694. Pro-лицензия добавляет журнал платежей со сверкой статусов, двухэтапную оплату (hold), частичные и повторные возвраты, сохранение карты покупателя для оплаты в 1 клик и событие автофискализации чека для ПРРО.

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

1. Покупатель в чекауте выбирает оплату картой monobank и подтверждает заказ.
2. Модуль обращается к API monobank, создаёт счёт с заданным временем жизни и перенаправляет покупателя на платёжную страницу банка — карту он вводит на стороне monobank, а не в вашем магазине.
3. Банк отправляет вебхук на адрес extension/mono_acquiring/payment/mono.callback. Модуль проверяет ECDSA-подпись (заголовок X-Sign) и ставит заказу статус, который вы выбрали в настройках: отдельно для успешной оплаты, неудачной/просроченной и возврата.
4. При двухэтапной оплате (Pro) средства сначала блокируются на карте, а списываются, когда вы подтверждаете заказ — удобно, если надо проверить наличие товара перед списанием.
5. Возврат (Pro) делается из журнала платежей в админке: полный или на указанную сумму, без входа в кабинет банка.

Что включено в лицензии

Сколько стоит

1 490 грн — разовая покупка. Лицензия бессрочная: платите один раз, обновления и техническая поддержка входят в цену. Один ключ — один домен и его поддомены.

Переносите магазин на другой домен — деактивируйте лицензию на старом и активируйте на новом самостоятельно в кабинете.

Лицензия бессрочная — ничего не истекает и не выключается. Один ключ — один домен; переносите магазин — деактивируйте лицензию на старом домене и активируйте на новом самостоятельно.

Один ключ — один домен. Переносите магазин — деактивируйте лицензию на старом домене и активируйте на новом самостоятельно, без обращения в поддержку.

Сначала триал, потом оплата. Свежая установка — это бесплатная версия: Pro сам не включается и ничего не гаснет через неделю. Когда захотите посмотреть Pro — нажмите «Попробовать Pro» в настройках модуля, укажите email и получите ключ на 7 дней (он же придёт письмом). Так что журнал операций, hold и возвраты вы проверяете на собственном магазине ещё до покупки — именно поэтому возврат средств после оплаты не предусмотрен.

Технические требования

• OpenCart 4.x — нативное расширение, устанавливается стандартным инсталлятором; для 3.0.x и 2.3.0.x в комплекте отдельные сборки (2.3 заливается файлами, потому что штатный инсталлятор той версии умеет только FTP)
• Токен monobank: боевой (X-Token) — из кабинета мерчанта после заключения договора; тестовый — бесплатно на api.monobank.ua
• Магазин должен быть доступен из интернета по HTTPS — иначе вебхук от банка не дойдёт

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

• Криптографическая проверка вебхуков: подпись X-Sign (base64 ECDSA-SHA256) сверяется с публичным ключом мерчанта — фальшивый запрос «заказ оплачен» модуль отвергнет.
• Собственные таблицы cc_mono_order и cc_mono_card — платежи и wallet-токены карт хранятся отдельно и не трогают стандартные таблицы OpenCart.
• Полный API-клиент monobank: создание счёта с передачей состава корзины (basketOrder), запрос статуса, finalize для hold-платежей, возвраты.
• Двуязычная админка — украинская и английская локализации из коробки.
• Автофискализация через событие OpenCart — ПРРО-модуль подписывается на событие и выдаёт чек сразу после успешной оплаты.

Как установить

1. Загрузите mono_acquiring.ocmod.zip через Расширения → Инсталлятор в админке OpenCart. Для 3.0.x берите mono_acquiring-oc3.ocmod.zip, для 2.3 — mono-oc2.ocmod.zip и залейте папку upload/ в корень магазина по SFTP.
2. В списке Расширения → Платежи найдите Mono Acquiring и нажмите «Установить» — модуль создаст свои таблицы. Pro при этом не включается: триал выдаётся только кликом «Попробовать Pro» в настройках.
3. Откройте настройки, вставьте токен (тестовый или боевой) и нажмите «Проверить токен» — увидите название вашего мерчанта.
4. Выберите тип платежа (списание сразу или hold), статусы заказов и сохраните.
5. URL вебхука модуль показывает в настройках и передаёт банку автоматически при создании счёта.
6. Для Pro после покупки вставьте лицензионный ключ из email в поле «Pro-лицензия».

История версий

1.1.0 (OpenCart 3.x) — 10 августа 2026

Сборка под OpenCart 3.0.x перестроена с нуля до уровня версий 4.x и 2.3: та же модель Free/Pro с триалом по клику, журнал платежей, возвраты из админки, двухэтапная оплата, сохранение карты и автофискализация. По сравнению со старой сборкой 1.0.5 исправлены две денежные ошибки: сумма возврата теперь переводится в валюту счёта monobank (раньше запрос на $150 возвращал 150 ₴), а частичный возврат больше не закрывает заказ — monobank помечает счёт «reversed» даже когда возвращена часть, поэтому остаток оставался невозвращённым. Проверено живыми оплатами на тестовом мерчанте: оплата картой, частичный и полный возврат, подпись вебхука. ⚠️ Двухэтапная оплата (hold) в monobank доступна только для гривны.

1.1.0 (OpenCart 2.3) — 7 августа 2026

Сборка под OpenCart 2.3.0.x: та же модель Free/Pro и триал по клику, журнал, возвраты, двухэтапная оплата, сохранение карты и автофискализация. Исправлено против старших сборок: сумма возврата теперь переводится в валюту счёта monobank (раньше запрос на $150 возвращал 150 ₴); частичный возврат больше не закрывает заказ — monobank помечает счёт «reversed» даже когда возвращена часть, поэтому остаток оставался невозвращённым; поздний вебхук «processing» больше не затирает конечный статус в журнале; данные карты не стираются при списании заблокированных средств. ⚠️ Двухэтапная оплата (hold) в monobank доступна только для гривны.

1.1.0 — 2 августа 2026

Перестроено Free/Pro: свежая установка — чистая бесплатная версия, 7-дневный триал стартует только вашим кликом и выдаётся как настоящий ключ на почту. Pro-граница теперь видима на месте: двухэтапная оплата, сохранение карты, автофискализация и журнал остаются на экране, но серые, с пояснением пользы. Исправлено: событие списания заблокированных средств регистрировалось с точкой вместо «*» — на OpenCart 4 двухэтапная оплата не срабатывала вообще; колбэк с заниженной суммой больше не сохраняется как успешная оплата (раньше это навсегда блокировало следующую полную); полный возврат больше не пишется в историю дважды; частичные возвраты считаются накопительно, а враждебная сумма отбивается до обращения в API; лицензия переживает недоступность catcode.com.ua (14-дневный льготный период).

1.0.3 — 23 июля 2026

Исправлен конфликт при оформлении заказа на OpenCart 4.0.2.x: проверка гео-зоны больше не загружает отсутствующую в этой версии каталога модель и не блокирует выбор способа оплаты или доставки.

1.0.1 — июль 2026

Исправлена установка на OpenCart 4.1: событие списания удержания регистрировалось в формате OpenCart 4.0, из-за чего установка модуля прерывалась ошибкой.

1.0.0 — июль 2026

Первый публичный релиз: оплата на платёжной странице monobank, вебхук-подтверждение с проверкой ECDSA-подписи, тестовый режим, настройка статусов и гео-зоны; в Pro — журнал платежей, двухэтапная оплата (hold), возвраты, сохранение карты, событие автофискализации.