Hutko — оплата карткою для WooCommerce

Hutko for WooCommerce — платіжний плагін для приймання оплат карткою Visa/Mastercard, Apple Pay та Google Pay через еквайринг Hutko. Оплата відбувається на захищеній сторінці Hutko, а підтвердження замовлення — без вашої участі: Hutko надсилає server-callback на REST-вебхук магазину, плагін перевіряє SHA1-підпис і переводить замовлення у «В обробці» чи «Виконано». Замовлення закривається оплаченим тільки тоді, коли гроші реально пройшли.

Базова версія — безкоштовна. Завантажити: hutko-for-woocommerce.zip. Pro-ліцензія відкриває журнал платежів зі звіркою статусів, двоетапну оплату (preauth-блокування + capture-списання) і повні та часткові повернення (reverse) з адмінки.

Що отримує адмін

Як це працює — крок за кроком

1. Покупець обирає «Оплата карткою (Hutko)» на чекауті — класичному або блоковому — і оформлює замовлення.
2. Плагін підписує запит і перенаправляє покупця на захищену сторінку оплати Hutko.
3. Після оплати Hutko надсилає підписаний callback на REST-маршрут wc-hutko/v1/webhook.
4. Плагін перевіряє SHA1-підпис і автоматично ставить замовленню налаштований статус.
5. Якщо покупець повернувся на сайт раніше за callback — плагін сам звіряє статус транзакції через Status API.
6. З Pro: у момент виконання замовлення заблокована сума списується (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 і повернення можна перевірити на власному магазині ще до покупки. Саме тому повернення коштів після оплати не передбачене — ви бачите модуль у справі до того, як платите.

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

• WooCommerce 6.0+ · WordPress 5.8+
• PHP 7.4+
• Merchant ID і secret key з кабінету Hutko — для бойових оплат; тестовий режим працює одразу, без договору

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

• Окремий REST-маршрут для callback-ів — wc-hutko/v1/webhook; кожен запит проходить перевірку SHA1-підпису до будь-якої зміни замовлення.
• server_callback_url передається у кожному платежі — прописувати його вручну в кабінеті Hutko не потрібно.
• Secret key зберігається у БД зашифрованим, а не відкритим текстом у таблиці опцій.
• Сумісність з HPOS і блоковим чекаутом заявлена через WooCommerce FeaturesUtil — плагін готовий до сучасних інсталяцій Woo.
• Логування у WooCommerce → Статус → Журнали — при розборі спірної оплати видно кожен запит і відповідь.

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

1. Плагіни → Додати новий → Завантажити: оберіть hutko-for-woocommerce.zip і активуйте плагін.
2. Відкрийте WooCommerce → Налаштування → Оплата і увімкніть Hutko.
3. Для перевірки лишіть «Тестовий режим»: оплати підуть через публічний тестовий мерчант Hutko, реальні кошти не рухаються.
4. Для бойового режиму впишіть Merchant ID і secret key з кабінету Hutko.
5. Для Pro: після покупки вставте ліцензійний ключ з email у налаштування шлюзу.

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

1.0.0 — липень 2026

Перший публічний реліз: оплата Visa/Mastercard, Apple Pay, Google Pay через сторінку Hutko; server-callback з перевіркою SHA1-підпису на REST-маршруті; звірка через Status API; класичний і блоковий чекаут, HPOS; валюти UAH/USD/EUR/GBP/CZK; Pro — журнал платежів, preauth/capture, повернення reverse; 7-денний тріал Pro.