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

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

Как работает mono acquiring в OpenCart

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

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

• Криптографическая проверка вебхуков: подпись 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-oc3-1.1.3.ocmod.zip, для 2.3 — mono-oc2-1.1.2.ocmod.zip и залейте папку upload/ в корень магазина по SFTP.
2. В списке Расширения → Платежи найдите Mono Acquiring и нажмите «Установить» — модуль создаст свои таблицы. Pro при этом не включается: триал выдаётся только кликом «Попробовать Pro» в настройках.
3. Откройте настройки, вставьте токен (тестовый или боевой) и нажмите «Проверить токен» — увидите название вашего мерчанта.
4. Выберите тип платежа (списание сразу или hold), статусы заказов и сохраните.
5. URL вебхука модуль показывает в настройках и передаёт банку автоматически при создании счёта.
6. Для Pro после покупки вставьте лицензионный ключ из email в поле «Pro-лицензия».