WooCommerce

Accept ICEPAY payments in your WooCommerce store using the ICEPAY for WooCommerce plugin.

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.

Download

Changelog

Source code

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 different payment outcomes

We recommend testing more than a successful payment. Verify that your store also handles cancelled 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 generally do not need to create your own redirect or payment status endpoints when using the WooCommerce plugin.

Payment updates and customer redirects happen independently and can arrive in either order. The plugin uses the server-side payment update to update the order status.

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 mode to Live mode 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 live

Prepare to process live payments.

Troubleshooting

ICEPAY payment methods are not visible at checkout

Check that:

• The ICEPAY plugin is installed and activated.
• The payment method is enabled in WooCommerce → Settings → Payments.
• The correct ICEPAY merchant is connected.
• The payment method is enabled for your ICEPAY merchant.
• Your store meets the required WordPress, WooCommerce, and PHP versions.

If the payment method still does not appear, check the WooCommerce logs for related errors.

The payment remains pending

Open the corresponding order in WooCommerce → Orders and review the order notes.

Then check the payment in the ICEPAY Portal and compare its status with the WooCommerce order.

If the payment has been completed in ICEPAY but the WooCommerce order has not been updated, contact the ICEPAY team with the order number, payment reference, Merchant ID, and approximate time of the payment.

Do not include your Merchant Secret in a support request.

The customer cannot complete the payment

Confirm that:

• The correct Merchant ID and Merchant Secret are configured.
• The ICEPAY merchant is enabled.
• The selected payment method is available for the merchant.
• Your WooCommerce store can communicate with ICEPAY.

If an error is shown, include the error message when contacting the ICEPAY team.

The payment status in WooCommerce differs from the ICEPAY Portal

Refresh the WooCommerce order and review its order notes.

Use the payment details and server-side payment status in the ICEPAY Portal when investigating the payment.

If the statuses remain different, contact the ICEPAY team with the WooCommerce order number, payment reference, Merchant ID, and approximate time of the payment.

The plugin does not work after an update

Confirm that your WordPress, WooCommerce, PHP, and ICEPAY plugin versions are compatible.

Clear any application or page caches and test the checkout again.

If the issue continues, check the WooCommerce logs and contact the ICEPAY team with the plugin version, WooCommerce version, PHP version, and any relevant error message.