Hutko — оплата карткою для OpenCart 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 990 грн — ліцензія на рік. Рік оновлень, технічної підтримки та доступу до всіх Pro-функцій. Без автосписань: продовження завжди вручну, реквізити картки ми не зберігаємо.

Можна одразу взяти довший термін — що довший, то дешевше за рік:

• 1 рік — 1 990 грн
• 2 роки — 3 780 грн (−5%, по 1 890 грн за рік)
• 3 роки — 5 250 грн (−12%, по 1 750 грн за рік)
• 4 роки — 6 530 грн (−18%, по 1 630 грн за рік)
• 5 років — 7 460 грн (−25%, по 1 490 грн за рік)

Коли термін спливає, вимикаються лише Pro-функції — безкоштовна версія працює далі, налаштування і дані нікуди не діваються. Щоб знову відкрити Pro, достатньо продовжити ліцензію в особистому кабінеті. Нагадаємо на пошту за 14, 7, 3 і 1 день до завершення.

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

Спершу тріал, потім оплата. Одразу після встановлення вмикається 7-денний безкоштовний Pro-тріал: журнал операцій, preauth/capture і повернення можна перевірити на власному магазині ще до покупки. Саме тому повернення коштів після оплати не передбачене — ви бачите модуль у справі до того, як платите.

Технічні вимоги

• OpenCart 4.0.2 – 4.1.x (нативна збірка) або OpenCart 3.0.2 – 3.0.5.0 (окрема збірка)
• PHP 8.0+
• Merchant ID і secret key з кабінету Hutko — потрібні тільки для бойового режиму

Що під капотом

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

Як встановити

1. Розширення → Інсталятор: завантажте hutko.ocmod.zip. Для OpenCart 3.0.x беріть збірку hutko-oc3.ocmod.zip із завантажень товару.
2. У Розширення → Платежі знайдіть Hutko і натисніть «Встановити», потім відкрийте налаштування.
3. Увімкніть модуль і для першої перевірки лишіть тестовий режим — оплата піде через публічний тестовий мерчант.
4. Для реальних оплат вимкніть тест і впишіть Merchant ID та secret key з кабінету Hutko.
5. Для Pro: вставте ліцензійний ключ з email після покупки — журнал і розширені функції з’являться одразу, без переустановлення.

Історія версій

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.