WooCommerce

WooCommerce

The ‘ICEPAY for WooCommerce’ plugin connects your WooCommerce store to ICEPAY and adds supported ICEPAY payment methods to your checkout.

This guide explains how to install the plugin, connect your ICEPAY merchant, configure your payment methods, and test your checkout before going Live.

Requirements

Before installing the plugin, make sure your store meets the following requirements:

• WordPress 6.6 or higher
• WooCommerce 8.7 or higher
• PHP 8.2 or higher
• An ICEPAY account with access to a merchant

Start in Test mode

New ICEPAY merchants start in Test mode. We recommend completing the installation and testing your checkout before switching your merchant to Live mode.

Install the plugin

The plugin can be installed manually using the ZIP package from the latest ICEPAY for WooCommerce release.

1. Download the plugin

   Download the latest icepay-for-woocommerce ZIP package from the ICEPAY for WooCommerce releases.

2. Open your WordPress plugins

   Sign in to your WordPress Admin and go to Plugins → Add New Plugin.

3. Upload the plugin

   Click Upload Plugin, select the ZIP file you downloaded, and click Install Now.

4. Activate the plugin

   Once the installation is complete, activate ICEPAY for WooCommerce.

Connect your ICEPAY merchant

Next, connect the plugin to the ICEPAY merchant that will process your payments.

1. Open the ICEPAY settings

   In your WordPress Admin, go to WooCommerce → ICEPAY for WooCommerce.

2. Enter your merchant credentials

   Enter the Merchant ID and Merchant Secret for your ICEPAY merchant.

   You can find these credentials in the ICEPAY Portal by opening the merchant you want to connect.

3. Save your settings

   Confirm the entered credentials and click Save changes.

Keep your Merchant Secret secure

Your Merchant Secret is used to authenticate requests to ICEPAY. Do not share it publicly or expose it in your storefront.

Enable payment methods

After connecting your merchant, choose which ICEPAY payment methods you want to offer during checkout.

1. Open the WooCommerce payment settings

   Go to WooCommerce → Settings → Payments.

2. Enable your payment methods

   Enable the ICEPAY payment methods you want to make available to your customers.

3. Configure the payment methods

   Open an individual payment method to configure its settings, such as the name and description shown during checkout.

4. Save your changes

   Save your WooCommerce payment settings when you’re finished.

Supported payment methods

The ICEPAY for WooCommerce plugin currently supports:

• iDEAL | Wero
• Cards
• Bancontact
• PayPal
• Pay by Bank
• Online Überweisen

The payment methods available to your customers also depend on the payment methods enabled for your ICEPAY merchant.

Test your integration

Before accepting real payments, place at least one order through your WooCommerce checkout while your ICEPAY merchant is in Test mode.

1. Add a product to your cart

   Go through your store as a customer and add a product to the cart.

2. Proceed to checkout

   Enter the required customer details and select one of the ICEPAY payment methods.

3. Place the order

   Place the order and continue to the ICEPAY payment page.

4. Complete the test payment

   In Test mode, use the ICEPAY payment page to select the result of the test payment.

5. Check the WooCommerce order

   Return to WooCommerce → Orders and verify that the order status has been updated correctly.

6. Check the payment in the ICEPAY Portal

   Open the payment in the ICEPAY Portal and verify that its status matches the WooCommerce order.

Test more than a successful payment

We recommend testing different payment outcomes to make sure your store handles both completed and unsuccessful payments correctly.

How payments work

Once the plugin is configured, the payment flow is handled automatically.

1. The customer places an order

   The customer selects an ICEPAY payment method and places the order in WooCommerce.

2. The payment is created

   The plugin creates the payment with ICEPAY using the order information and billing details.

3. The customer completes the payment

   The customer continues to the ICEPAY payment page to complete the payment.

4. WooCommerce receives the payment result

   ICEPAY sends the payment status back to your store and the plugin updates the WooCommerce order accordingly.

You do not need to create your own redirect or payment status endpoints when using the WooCommerce plugin.

Source of truth

If the ICEPAY Portal and your WooCommerce store show different results, use the payment details and server-side payment status from ICEPAY when investigating the payment. Do not fulfil an order based only on a browser redirect.

Refund an order

Refunds can be initiated directly from WooCommerce for payments that support refunds.

1. Open the order

   Go to WooCommerce → Orders and open the order you want to refund.

2. Start the refund

   Click Refund and enter the amount you want to return to the customer.

3. Submit the refund

   Confirm the refund through the ICEPAY payment gateway.

You can issue a full refund or refund only part of the order amount.

Updating the plugin

Before updating the ICEPAY for WooCommerce plugin on a production store, we recommend testing the new version in a staging environment and creating a backup of your store.

Download the latest plugin release and follow the WordPress plugin update process to install the new version.

Go Live

Once you have successfully tested your store, you can prepare your ICEPAY merchant for real payments.

1. Verify your checkout

   Make sure your enabled payment methods appear correctly and that test orders receive the expected WooCommerce status.

2. Submit your merchant for approval

   Your merchant must be approved before it can process real payments.

3. Switch the merchant to Live mode

   Once approved, switch the merchant from Test to Live in the ICEPAY Portal.

4. Place a final order

   We recommend placing a small Live order to verify the complete payment flow.

Learn more about going LivePrepare to process live payments.

Troubleshooting

If a payment does not behave as expected:

• check the corresponding WooCommerce order and its order notes;
• verify the payment status in the ICEPAY Portal;
• confirm that the correct Merchant ID and Merchant Secret are configured;
• make sure the ICEPAY payment method is enabled in WooCommerce → Settings → Payments;
• confirm that your WordPress, WooCommerce, and PHP versions meet the plugin requirements.

Contact ICEPAY supportTell us about your setup and we'll help you find the right integration.