Huch API Documentation

Appearance

WordPress / WooCommerce Plugin Integration Guide ​

This guide explains how to install and configure the HUCH payment plugin on a WordPress site using WooCommerce.

Requirements ​

  • WordPress 5.5+ and WooCommerce 5.0+
  • An active HUCH merchant account
  • A valid HUCH API key
  • A site using HTTPS (recommended)

Step 1 – Plugin Installation ​

  1. Download the .zip file of the HUCH plugin
  2. In the WordPress admin panel, go to Plugins > Add New
  3. Click “Upload Plugin” and select the .zip file
  4. Click Install Now, then Activate

Step 2 – Plugin Configuration ​

Navigate to WooCommerce > Settings > Payments > HUCH and fill in:

  • API Key: copied from your HUCH merchant dashboard
  • Merchant ID: visible on your merchant account
  • Mode: Sandbox (test) or Production (live)
  • Redirect URLs:
    • Success URL: https://yourwebsite.com/thank-you
    • Failure URL: https://yourwebsite.com/payment-failed

Step 3 – Webhook Configuration ​

In your HUCH dashboard, set the following webhook URL:

https://yourwebsite.com/?wc-api=wc_huch_webhook

This allows WooCommerce to receive real-time updates about the payment status.

Step 4 – Testing the Integration ​

  1. Enable Sandbox mode
  2. Make a test order using a test IBAN (if available)
  3. Ensure the WooCommerce order status updates from “Pending” to “Processing” or “Completed”

Need Help? ​

Feel free to reach out to our support team at support@huch.tech