PrestaShop

The ICEPAY for PrestaShop module connects your PrestaShop store to ICEPAY and adds supported ICEPAY payment methods to your checkout.

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

Requirements

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

• PrestaShop 1.7 or higher
• PHP 7.2 or higher
• An ICEPAY Account with access to a merchant

Start in Test mode

New ICEPAY merchants start in Test mode. We recommend installing and testing the module in a test or staging environment before accepting real payments.

Install the module

The ICEPAY module can be installed from the PrestaShop back office using the ZIP package from the latest release.

1. Download the module

   Download the latest icepay.zip package from the ICEPAY for PrestaShop releases.

2. Open the Module Manager

   Sign in to your PrestaShop back office and go to Modules → Module Manager.

3. Upload the module

   Click Upload a module and select the icepay.zip file you downloaded.

4. Configure the module

   Once the installation is complete, open ICEPAY Integration and click Configure.

Tip

We recommend creating a backup of your store before installing or updating modules in a production environment.

Configure ICEPAY

Connect the module to the ICEPAY merchant that will process your payments.

1. Open the ICEPAY configuration

   Go to Modules → Module Manager, find ICEPAY Integration, and click Configure.

2. Enter your merchant credentials

   Enter the Merchant ID and Merchant Secret of the ICEPAY merchant you want to connect.

   You can find these credentials in the ICEPAY Portal by opening Merchants and selecting your merchant.

3. Configure the order statuses

   Select the PrestaShop order statuses that should be used for successful, pending, and unsuccessful payments.

4. Save the configuration

   Save your changes to connect the module to ICEPAY.

Keep your Merchant Secret secure

Your Merchant Secret is used to authenticate requests to ICEPAY. Do not share it publicly or include it in support requests.

Configure payment methods

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

1. Open the module configuration

   Go to Modules → Module Manager → ICEPAY Integration → Configure.

2. Choose your payment methods

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

3. Configure payment method settings

   Review the available settings for each payment method, including its description and the countries where it should be available.

4. Save your changes

   Save the configuration when you’re finished.

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

Supported payment methods

The ICEPAY for PrestaShop module currently supports:

• iDEAL | Wero
• Cards
• Bancontact
• PayPal
• Online Überweisen
• EPS
• Carte Bancaire
• Dankort
• Pay by Bank

Test your integration

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

1. Add a product to your cart

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

2. Proceed to checkout

   Enter the required customer information and select an ICEPAY payment method.

3. Place the order

   Confirm the order and continue to the payment page.

4. Complete the test payment

   In Test mode, select the result you want to simulate on the ICEPAY Payment Page.

5. Check the PrestaShop order

   Open the order in your PrestaShop back office and verify that its status has been updated correctly.

6. Check the payment in the ICEPAY Portal

   Open the corresponding test payment in the ICEPAY Portal and verify that its status matches the PrestaShop order.

Test different payment outcomes

We recommend testing more than a successful payment. Verify that your store also handles pending, cancelled, and unsuccessful payments correctly.

How payments work

Once the module is installed and configured, the payment flow is handled automatically.

1. The customer places an order

   The customer selects an ICEPAY payment method during checkout and confirms the order.

2. The payment is created

   The module creates the payment with ICEPAY using the PrestaShop order information.

3. The customer completes the payment

   The customer is redirected to the payment page to complete the payment.

4. The module updates the order and the customer can return

   ICEPAY sends a webhook to the module, which validates the payment and updates the order status. The customer is also redirected back to your PrestaShop store after completing or cancelling the payment.

You do not need to create your own payment redirect or webhook endpoints when using the PrestaShop module.

Webhooks and customer redirects happen independently and can arrive in either order. The order status is updated from the verified payment update, even if the customer closes the page without returning.

Refund an order

The ICEPAY module supports both full and partial refunds directly from the PrestaShop back office.

1. Open the order

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

2. Start the refund

   Use the available refund action on the order details page.

3. Choose the refund amount

   Refund the complete payment or enter an amount for a partial refund.

4. Submit the refund

   Confirm the refund. The module sends the request to ICEPAY and records the result in the order history.

Caution

Cancelling an order in PrestaShop does not automatically refund the payment. Use the refund action when funds need to be returned to the customer.

Go live

Once you’ve successfully tested the integration, you can prepare your store for real payments.

1. Verify your checkout

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

2. Submit your merchant for approval

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

3. Switch your merchant to Live mode

   Once approved, change 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.

Going live

Test payments do not process real funds. After switching your merchant to Live mode, payments placed through your PrestaShop store are real transactions.

Learn more about going live

Prepare to process live payments.

Update the module

We recommend testing module updates in a staging environment before deploying them to your production store.

1. Download the latest release

   Download the latest ICEPAY for PrestaShop ZIP package.

2. Open the Module Manager

   Go to Modules → Module Manager in your PrestaShop back office.

3. Install the updated module

   Upload the new module package using the PrestaShop module installation process.

4. Verify your configuration

   After updating, confirm that your ICEPAY credentials, payment methods, and order status settings are still configured correctly.

5. Test the checkout

   Place a test order and verify that the complete payment flow works as expected.

Tip

Create a backup of your store before updating modules in a production environment.

Troubleshooting

ICEPAY payment methods are not visible at checkout

Check that:

• The ICEPAY module is installed and enabled.
• The correct ICEPAY merchant is configured.
• The payment method is enabled in the ICEPAY module configuration.
• The payment method is enabled for your ICEPAY merchant.
• The payment method is available for the customer’s country.
• Your PrestaShop and PHP versions meet the module requirements.

If the payment method still does not appear, clear the PrestaShop cache and test the checkout again.

The payment remains pending

Open the corresponding order in the PrestaShop back office and review its order history.

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

If the payment has been completed in ICEPAY but the PrestaShop order has not been updated, verify that your store can receive webhook requests from ICEPAY.

If the issue continues, 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 PrestaShop store can communicate with ICEPAY.
• Your store is accessible over HTTPS.

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

The customer is not redirected back to the store

Make sure your PrestaShop storefront is publicly accessible and uses HTTPS.

If the payment itself was completed successfully, check the payment in the ICEPAY Portal before taking further action.

A browser redirect should not be used on its own to determine the final payment status.

The payment status in PrestaShop differs from the ICEPAY Portal

Open the PrestaShop order and review its order history.

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

If the statuses remain different, verify that payment status updates from ICEPAY can reach your store.

Contact the ICEPAY team with the PrestaShop order number, payment reference, Merchant ID, and approximate time of the payment if the issue continues.

A refund cannot be processed

Confirm that:

• The original payment supports refunds.
• The payment has reached a status that allows a refund.
• The refund amount does not exceed the refundable amount.
• The correct ICEPAY merchant credentials are configured.

Review the order history for information about the failed refund.

If the refund still cannot be processed, contact the ICEPAY team with the order number, payment reference, Merchant ID, and any relevant error message.

The module does not work after an update

Confirm that your PrestaShop, PHP, and ICEPAY module versions are compatible.

Make sure the ICEPAY module is still installed and enabled, then clear the PrestaShop cache.

Verify that your Merchant ID, Merchant Secret, payment methods, country settings, and order status mappings are still configured correctly.

If the issue continues, contact the ICEPAY team with the module version, PrestaShop version, PHP version, and any relevant error message.