Description
HUCH for WooCommerce adds the HUCH instant bank-to-bank payment gateway to your WooCommerce store. Customers pay directly from their bank account using Open Banking — no cards, no intermediaries, no card data stored.
Why HUCH?
- Instant settlement — payments are confirmed in real time
- Lower transaction fees — no card-network costs
- Bank-grade security — regulated Open Banking authentication
- Reduced PCI-DSS scope — no card data ever touches your server
Features
- Separate sandbox and production credential fields
- One-click Test API connection button in the settings page
- Automatic pending-payment status polling via WP-Cron (hourly fallback)
- Full WooCommerce refund support via the HUCH payout API
- Real-time payment status updates via signed webhooks
- Detailed order notes and WooCommerce log integration
- HPOS (High-Performance Order Storage) compatible
- Sandbox mode for development and QA testing
Requirements
- WordPress 5.8 or higher
- WooCommerce 6.0 or higher
- PHP 7.4 or higher
- An active HUCH merchant account (sandbox accounts available at huch.tech)
External services
This plugin connects to the HUCH Open Banking API in order to initiate payments, retrieve payment statuses, process webhook notifications, and handle refunds.
Services used:
- Sandbox API: https://api-gateway-sandbox.huch.tech
- Production API: https://api-gateway.huch.tech
- Documentation: https://apidocs.huch.tech
Data transmitted may include:
- Order amount
- Currency
- Order reference
- Merchant identifier
- Customer email
- Billing information
- Payment metadata required for payment processing
Data is transmitted when:
- A customer places an order
- Payment status is checked
- A webhook notification is processed
- A refund request is triggered
Service provider: HUCH
Terms of Service: https://huch.tech/terms-of-use/
Privacy Policy: https://huch.tech/privacy-policy/
Screenshots
Installation
- In your WordPress admin go to Plugins Add New Upload Plugin.
- Upload the plugin zip file and click Install Now, then Activate Plugin.
- Go to WooCommerce Settings Payments and click Manage next to HUCH.
- Enter your Merchant ID and the Client ID / Client Secret for each environment.
- Select the active environment (Sandbox for testing, Production for live payments).
- Click Save changes.
- Register your webhook URL in your HUCH merchant dashboard (see FAQ).
Obtaining your credentials
Log in to your HUCH merchant dashboard, navigate to API Settings, and copy your:
- Merchant ID — shared across environments
- Sandbox Client ID & Client Secret — for test payments
- Production Client ID & Client Secret — for live payments
FAQ
-
Where do I get my API credentials?
-
Log in to your HUCH merchant account at huch.tech and navigate to the API settings section to retrieve your Merchant ID, Client ID, and Client Secret for each environment.
-
How do I test the integration before going live?
-
Set the Environment to Sandbox in the plugin settings and enter your sandbox credentials. Use the Test API connection button to verify they are correct. No real transactions are processed in sandbox mode.
-
What is my webhook URL?
-
Your webhook endpoint is:
https://yoursite.com/?woocommerce-api=wc_huch_webhookRegister this URL in your HUCH merchant dashboard to receive real-time payment status updates. Replace
yoursite.comwith your actual domain. -
What currencies are supported?
-
HUCH supports all currencies available in your WooCommerce store. The currency is passed automatically from the order at the time of payment.
-
Are refunds supported?
-
Yes. Full and partial refunds can be issued directly from the WooCommerce order screen. The refund is submitted automatically to the HUCH payout API and a confirmation note is added to the order.
-
What happens if a payment fails?
-
The customer is redirected back to the checkout page with an error message. The order remains in “Pending” status and no charge is made.
-
What happens if my site misses a webhook?
-
A WP-Cron job runs hourly and polls the HUCH API for any HUCH orders still in “Pending” or “On Hold” status, so payment statuses are reconciled automatically even if a webhook was not delivered.
-
Is HPOS / High-Performance Order Storage supported?
-
Yes. The plugin uses
wc_get_orders()for all order lookups, which is fully compatible with both classic and HPOS order storage.
Reviews
There are no reviews for this plugin.
Contributors & Developers
“HUCH for WooCommerce” is open source software. The following people have contributed to this plugin.
Contributors
Translate “HUCH for WooCommerce” into your language.
Interested in development?
Browse the code, check out the SVN repository, or subscribe to the development log by RSS.
Changelog
2.0.1
- Added separate sandbox and production credential fields
- Added one-time automatic credential migration for installs upgrading from 2.0.0
- Added Test API connection button in the settings page
- Added WP-Cron fallback to poll pending payment statuses hourly
- Added full and partial refund support via the HUCH payout API
- Improved admin settings layout with two-column credential blocks
- Improved webhook handling with idempotent order-status transitions
- Added HPOS-compatible order lookups via wc_get_orders()
2.0.0
- Initial public release
- OAuth2 client-credentials authentication with token caching
- Sandbox and production environments
- Real-time webhook payment status handler
- Debug logging via WooCommerce log system