Hutko — оплата картой и частями ПУМБ для OpenCart 2.3, 3.x и 4.x

Hutko для OpenCart — модуль оплаты, который принимает карты Visa и Mastercard через эквайринг Hutko в магазинах на OpenCart 2.3, 3.x и 4.x. Ввод карты происходит на защищённой странице Hutko, а результат возвращается в магазин подписанным server-callback-ом: модуль проверяет SHA1-подпись и сам выставляет заказу правильный статус. Оплаченные и неоплаченные заказы разделяются автоматически, без ручной сверки с кабинетом.

С версии 1.2.0 — ещё и «Оплата частями ПУМБ». Отдельного API для онлайн-рассрочки у ПУМБ нет: банк продаёт её через свой сервис hutko. Модуль добавляет на чекаут отдельный способ оплаты, и покупатель сразу попадает на страницу Hutko с рассрочкой ПУМБ — до 24 платежей, подтверждение в приложении банка. Магазин получает всю сумму сразу, а риск невозврата берёт на себя банк. Работает на OpenCart 4, 3 и 2.3.

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

1. На чекауте покупатель выбирает «Оплата картой (Hutko)» и подтверждает заказ.
2. Модуль формирует подписанный запрос и отправляет покупателя на защищённую страницу оплаты Hutko.
3. Hutko проводит платёж и отправляет магазину server-callback с SHA1-подписью.
4. Модуль проверяет подпись — и заказ получает нужный статус в OpenCart без участия менеджера.
5. При возврате покупателя статус дополнительно сверяется, поэтому «оплаченным» заказ становится только после реального прохождения средств.
6. Оплата частями ПУМБ: покупатель вводит на странице Hutko телефон, привязанный к приложению ПУМБ, выбирает количество платежей и подтверждает рассрочку в приложении. Пока подтверждения нет, заказ ждёт оплаты с отметкой в истории; как только банк одобрил — приходит callback, и заказ получает статус «оплачен» на полную сумму.
7. С Pro: заблокированная preauth-сумма списывается (capture), когда вы переводите заказ в выполненный статус, а возвраты делаете из журнала платежей.

Оплата частями ПУМБ: условия

• От 3 до 24 платежей без комиссии для покупателя; первый платёж — через 30 дней.
• Сумма покупки — от 500 до 300 000 грн; фактический лимит зависит от кредитной истории покупателя и лимита на его карте ПУМБ.
• Магазин получает всю сумму на счёт в ПУМБ на следующий рабочий день, риск невозврата берёт банк.
• Что нужно магазину: бизнес-счёт в ПУМБ, мерчант Hutko и заявка в поддержку hutko на подключение услуги. Условия банка и тарифы — на странице hutko.org «Оплата частями от ПУМБ»; их устанавливает банк, и они могут меняться.
• Пока услуга не подключена, Hutko не создаёт такой платёж; покупатель увидит просьбу выбрать другой способ оплаты.
• Оплата частями входит в бесплатную версию модуля.

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

• Нативный код под OpenCart 4 — неймспейсы, Twig, штатный инсталлятор; для OpenCart 3 и 2.3 собраны отдельные порты, а не один архив «на все версии».
• Secret key хранится зашифрованным (AES-256-CBC + HMAC) с привязкой к установке — в дампе БД открытого ключа не будет.
• Callback без валидной SHA1-подписи отклоняется — статус заказа невозможно изменить сторонним запросом.
• Рассрочка — это тот же Hutko: модуль передаёт payment_systems=installments, поэтому страница оплаты открывается сразу на рассрочке ПУМБ. Callback, SHA1-подпись, сверка статуса и защита от недоплаты — те же, что и для карты. В OpenCart 4 это вторая опция способа Hutko, в OpenCart 3 и 2.3 — отдельное платёжное расширение «Hutko — оплата частями ПУМБ».
• Мягкий Pro-гейт: Pro-поля видно всегда, но без ключа они серые — сразу понятно, что именно даёт лицензия. После завершения триала без ключа отключаются только Pro-функции, бесплатный приём оплат не останавливается.

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

1. Расширения → Инсталлятор: загрузите hutko.ocmod.zip. Для OpenCart 3.0.x берите hutko-oc3-1.2.1.ocmod.zip, для OpenCart 2.3 — hutko-oc2-1.2.1.ocmod.zip из загрузок товара.
2. OpenCart 2.3: штатный Инсталлятор в этой версии копирует файлы только по FTP, поэтому содержимое папки upload/ из архива заливается в корень магазина файловым менеджером или по SFTP — ядро при этом не перезаписывается.
3. В Расширения → Платежи найдите Hutko и нажмите «Установить», затем откройте настройки.
4. Включите модуль и для первой проверки оставьте тестовый режим — оплата пойдёт через публичный тестовый мерчант.
5. Для реальных оплат выключите тест и впишите Merchant ID и secret key из кабинета Hutko.
6. Оплата частями ПУМБ: после подключения услуги в hutko в OpenCart 4 откройте вкладку «Оплата частями ПУМБ» в настройках Hutko; в OpenCart 3 и 2.3 установите в Расширения → Платежи «Hutko — оплата частями ПУМБ». Включите и при необходимости измените границы суммы.
7. Для Pro: вставьте лицензионный ключ из email после покупки — журнал и расширенные функции появятся сразу, без переустановки.