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

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

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

Что получает админ

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

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

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

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

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

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

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

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

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

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

• OpenCart 4.0.2 – 4.1.x (нативная сборка), OpenCart 3.0.2 – 3.0.5.0 или OpenCart 2.3.0.x — отдельные сборки
• PHP 8.0+ для OpenCart 4, 7.x для OpenCart 3, 5.6–7.x для OpenCart 2.3
• Merchant ID и secret key из кабинета Hutko — нужны только для боевого режима

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

• Нативный код под OpenCart 4 — неймспейсы, Twig, штатный инсталлятор; для OpenCart 3 собран отдельный порт, а не один архив «на все версии».
• Secret key хранится обфусцированным с привязкой к установке — в дампе БД открытого ключа не будет.
• Callback без валидной SHA1-подписи отклоняется — статус заказа невозможно изменить сторонним запросом.
• Мягкий Pro-гейт: Pro-поля видно всегда, но без ключа они серые — сразу понятно, что именно даёт лицензия. После завершения триала останавливаются только обновления и новые функции, а Pro-функции продолжают работать, бесплатный приём оплат не останавливается.

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

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

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

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

Сборка под OpenCart 2.3.0.x: та же модель Free/Pro и триал по клику, журнал платежей, двухэтапная оплата и возвраты. Оплата идёт через JSON-API Hutko с серверным редиректом. Исправлено против старших сборок: двойная запись «оплата получена» в истории заказа; сумма платежа теперь берётся в валюте заказа (а не в валюте взаиморасчётов) — иначе сравнение с суммой заказа давало ложную «недоплату»; возврат проверяет сумму — пустое поле означает полный возврат, а отрицательное или большее остатка число теперь отклоняется (раньше «-500» возвращало всю сумму), частичные возвраты учитываются накопительно.

1.1.0 — 2 августа 2026

Перестроена модель Free/Pro: свежая установка больше не включает Pro сама собой — 7-дневный триал выдаётся только кликом «Попробовать Pro» и приходит ключом в модалку и письмом. Лицензия проверяется на сервере CatCode с суточным кешем и 14-дневным льготным периодом, поэтому недоступность сайта не гасит Pro у плательщиков. Pro-поля теперь видно всегда, но без ключа они серые. Исправлено: колбэк с заниженной суммой больше не блокирует дальнейшее зачисление реальной оплаты — раньше такой заказ навсегда оставался «ожидает оплаты».

1.0.2 — 23 июля 2026

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

1.0.0 — июль 2026

Первый публичный релиз: оплата картой через защищённую страницу Hutko, server-callback с проверкой SHA1-подписи, сверка статуса при возврате, тестовый режим на публичном мерчанте, логирование запросов; Pro — журнал платежей с RRN и маскированной картой, preauth/capture, возвраты reverse. Сборки для OpenCart 4.0.2–4.1.x и 3.0.2–3.0.5.0.