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

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

Базовая версия — бесплатная. Скачать: hutko-for-woocommerce-1.1.1.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), а возврат делается из карточки заказа или из журнала.

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

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

890 грн — лицензия на год. Год обновлений, технической поддержки и доступа ко всем Pro-функциям. Без автосписаний: продление всегда вручную, реквизиты карты мы не храним.

Можно сразу взять более длинный срок — чем он длиннее, тем дешевле за год:

• 1 год — 890 грн
• 2 года — 1 690 грн (−5%, по 845 грн за год)
• 3 года — 2 350 грн (−12%, по 783 грн за год)
• 4 года — 2 920 грн (−18%, по 730 грн за год)
• 5 лет — 3 340 грн (−25%, по 668 грн за год)

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

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

Сначала триал, потом оплата. Свежая установка — это чистая бесплатная версия: ничего Pro само собой не включается. Когда захотите посмотреть Pro, в настройках шлюза есть кнопка «Попробовать Pro 7 дней бесплатно» — указываете e-mail и сразу получаете настоящий ключ на 7 дней (без карты). Журнал операций, 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-1.1.1.zip и активируйте плагин.
2. Откройте WooCommerce → Настройки → Оплата и включите Hutko.
3. Для проверки оставьте «Тестовый режим»: оплаты пойдут через публичный тестовый мерчант Hutko, реальные средства не двигаются.
4. Для боевого режима впишите Merchant ID и secret key из кабинета Hutko.
5. Для Pro: после покупки вставьте лицензионный ключ из email в настройки шлюза.

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

1.1.1 — август 2026

Исправлено: на магазинах с HPOS (по умолчанию в новом WooCommerce) одновременные колбек и возврат покупателя всё равно проводили оплату дважды — сброс классического кеша заказов там не действует, WooCommerce держит собственный.

1.1.0 — август 2026

Free — это действительно free: свежая установка больше не включает Pro сама собой, а пробный период на 7 дней стартует только кликом (e-mail → настоящий ключ лицензии). Pro-возможности остаются видимыми на своих местах с бейджем «Pro» и пояснением, что они дают; журнал платежей больше не исчезает из меню без лицензии. Лицензия проверяется на сервере CatCode с 14-дневным льготным периодом на случай недоступности. Исправлено: ключ лицензии больше не затирается обычным «Сохранить изменения», секретный ключ мерчанта не шифруется второй раз при повторном сохранении, одновременные callback и возврат покупателя больше не дублируют оплату, возврат на страницу магазина не показывает «оплата не завершена» на уже оплаченном заказе, в двухэтапном режиме заметка о блокировке средств не дублируется.

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.