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.