Hutko — card payments for WooCommerce

Hutko for WooCommerce is a payment plugin for accepting Visa/Mastercard, Apple Pay and Google Pay payments through Hutko acquiring. Payment happens on a secure Hutko page, and the order is confirmed without any action on your part: Hutko sends a server callback to the shop’s REST webhook, the plugin verifies the SHA1 signature and moves the order to “Processing” or “Completed”. An order is closed as paid only once the money has actually gone through.

The basic version is free. Download: hutko-for-woocommerce-1.1.1.zip. The Pro licence unlocks a payment log with status reconciliation, two-step payment (preauth hold + capture) and full and partial refunds (reverse) from the admin.

What the admin gets

How it works, step by step

1. The customer chooses “Card payment (Hutko)” at checkout — classic or block-based — and places the order.
2. The plugin signs the request and redirects the customer to a secure Hutko payment page.
3. After payment, Hutko sends a signed callback to the wc-hutko/v1/webhook REST route.
4. The plugin verifies the SHA1 signature and automatically sets the configured status on the order.
5. If the customer returns to the site before the callback arrives — the plugin itself reconciles the transaction status via the Status API.
6. With Pro: the held amount is captured the moment the order is completed, and refunds are made from the order screen or the log.

How much it costs

890 UAH — a one-year licence. A year of updates, technical support and access to all Pro features. No auto-charges: renewal is always manual, and we never store card details.

You can take a longer term straight away — the longer it is, the cheaper each year works out:

• 1 year — 890 UAH
• 2 years — 1,690 UAH (−5%, 845 UAH per year)
• 3 years — 2,350 UAH (−12%, 783 UAH per year)
• 4 years — 2,920 UAH (−18%, 730 UAH per year)
• 5 years — 3,340 UAH (−25%, 668 UAH per year)

Once the term expires, only updates and new features stop — Pro features keep working, the free version keeps running, and your settings and data don’t go anywhere. To reopen Pro, simply renew the licence in your account. We’ll remind you by email 14, 7, 3 and 1 day before it ends.

One key — one domain. Moving the shop, deactivate the licence on the old domain and activate it on the new one yourself, without contacting support.

Trial first, then payment. A fresh install is a plain free version: nothing Pro switches itself on. When you want to see Pro, the gateway settings have a “Try Pro free for 7 days” button — enter your email and get a real key for 7 days straight away (no card needed). The payment log, preauth/capture and refunds can be tested on your own shop before you buy. That’s exactly why refunds after purchase aren’t offered — you see the module at work before you pay.

Technical requirements

• WooCommerce 6.0+ · WordPress 5.8+
• PHP 7.4+
• Merchant ID and secret key from the Hutko account — for live payments; test mode works right away, no agreement needed

Under the hood

• A dedicated REST route for callbacks — wc-hutko/v1/webhook; every request goes through SHA1 signature verification before any change is made to the order.
• server_callback_url is sent with every payment — no need to enter it manually in the Hutko account.
• The secret key is stored encrypted in the database, not in plain text in the options table.
• HPOS and block-checkout compatibility is declared via WooCommerce FeaturesUtil — the plugin is ready for modern Woo installs.
• Logging in WooCommerce → Status → Logs — every request and response is visible when resolving a disputed payment.

How to install

1. Plugins → Add New → Upload: choose hutko-for-woocommerce-1.1.1.zip and activate the plugin.
2. Open WooCommerce → Settings → Payments and enable Hutko.
3. Leave “Test mode” on for a first check: payments go through Hutko’s public test merchant, no real money moves.
4. For live mode, enter the Merchant ID and secret key from the Hutko account.
5. For Pro: after purchase, paste the licence key from the email into the gateway settings.

Version history

1.1.1 — August 2026

Fixed: on shops with HPOS (typical for modern WooCommerce), a simultaneous callback and customer return could still process the payment twice — resetting the classic order cache doesn’t work there, as WooCommerce keeps its own.

1.1.0 — August 2026

Free is genuinely free: a fresh install no longer turns Pro on by itself, and the 7-day trial only starts on a click (email → real licence key). Pro features stay visible in their usual places with a “Pro” badge and an explanation of what they offer; the payment log no longer vanishes from the menu without a licence. The licence is checked on the CatCode server with a 14-day grace period in case it’s unreachable. Fixed: the licence key is no longer wiped by an ordinary “Save changes”, the merchant’s secret key is no longer double-encrypted on repeated saves, a simultaneous callback and customer return no longer duplicate the payment, returning to the shop page no longer shows “payment not completed” on an already-paid order, and the hold note in two-step mode is no longer duplicated.

1.0.0 — July 2026

First public release: Visa/Mastercard, Apple Pay, Google Pay payment via the Hutko page; a server callback with SHA1 signature verification on a REST route; reconciliation via the Status API; classic and block checkout, HPOS; UAH/USD/EUR/GBP/CZK currencies; Pro — payment log, preauth/capture, reverse refunds; 7-day Pro trial.