---
updatedAt: 2026-09-15T21:14:57.000Z
agentTools:
  projectIndex: https://docs.mollie.com/llms.txt
---

# PrestaShop: Troubleshooting

Learn troubleshooting techniques you can use before contacting support.

## Troubleshoot common issues

Follow the steps in [Troubleshoot common issues](/docs/troubleshoot-common-issues)article to ensure proper connection between Mollie and your PrestaShop instance and then the steps below for PrestaShop-specific settings.

## Troubleshooting checklist

### Enable debugging and get the log files

PrestaShop keeps a log of all Mollie-related activity that takes place. You can use the log to investigate the root cause of a problem.

1. Log in to PrestaShop.
2. In the left navigation menu, select **Mollie** > **Settings**.
3. Select the **Advanced settings** tab.
4. Scroll down to **Debug level**.
5. Switch on the **Display errors** toggle.
6. Select **Save**.

### Get the log files

To get the PrestaShop log file(s), follow these steps:

1. Log in to PrestaShop.
2. Go to **Advanced parameters** > **Logs**.

## Diagnose issues

### Check the release notes

Refer to [Mollie for PrestaShop releases](https://github.com/mollie/PrestaShop1.7/releases) to check whether the issue was fixed in a newer version of Mollie for PrestaShop.

<Callout icon="❗️" theme="error">
  Before updating Mollie for PrestaShop, review [Mollie for PrestaShop releases](https://github.com/mollie/PrestaShop1.7/releases) to ensure compatibility with your version of PrestaShop or third-party modules.
</Callout>

## Solve common problems

Below you can find a list of the most common issues you might run into and how to resolve them. Remember to always check the PrestaShop's own logs alongside this troubleshooting sheet.

|                                                                            |                                                                                                                                  |                                                                                                                                                                                                                          |
| :------------------------------------------------------------------------- | :------------------------------------------------------------------------------------------------------------------------------- | :----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Unable to install Mollie statuses                                          | This error happens when payment statuses can't be created.                                                                       | Check if Mollie order states that it already exist in shop. If it does, delete it from the PrestaShop's back office in your order settings, then try to reinstall the module.                                            |
| Unable to install voucher attributes                                       | This error happens when voucher features can't be installed.                                                                     | Check if this specific feature system works in PrestaShop. You can find more information on vouchers [here](https://www.prestashop.com/forums/topic/536730-tutorial-how-to-add-voucher-codes-and-discounts-cart-rules/). |
| Unable to register hooks                                                   | Sometimes it might happen that the [hooks](https://devdocs.prestashop-project.org/9/modules/concepts/hooks/) are not registered. | Check if the hooks are created & added in PrestaShop and that the module has all the correct permissions on the server side.                                                                                             |
| SQLSTATE\[23000]: Integrity constraint violation: 1062 Duplicate entry `X` | When store is just created or your PrestaShop version is `8.x`                                                                   | Restart the module if you get this error and check if it works after you log in again.                                                                                                                                   |
| PHP Fatal error: Allowed memory size of `X` bytes exhausted                | The PHP memory limit is too low for the installation process to complete                                                         | Increase the PHP memory limit in php.ini: `memory_limit = 256M` (or set it to a higher value).                                                                                                                           |
| Maximum execution time of `X` seconds exceeded                             | The PHP script execution time limit is too low                                                                                   | Increase `max_execution_time` in php.ini: `max_execution_time = 300`.                                                                                                                                                    |
| 500 Internal Server Error                                                  | PHP fatal error during installation                                                                                              | Check `var/logs/prod.log` for a more detailed view or enable debug mode to see the actual error.                                                                                                                         |
| The module is stuck in an infinite install loop.                           | Might happen during installing or upgrading a module                                                                             | Check `var/logs/prod.log` or PrestaShop logs for a detailed view of the errors. Also open the dev console in your browser (F12) -> then switch to the `Network` tab to see any potential errors.                         |

### Enabling Apple Pay in a one-page checkout

If you use a custom one-page checkout module together with Mollie for PrestaShop, Apple Pay might not work on the checkout page.

To work around this problem, follow these steps:

1. In your PrestaShop instance, go to `PrestaShop/modules/Mollie/mollie.php`.
2. In the `mollie.php` file, add a custom `instanceOf` check for your module to the `hookActionFrontControllerSetMedia` function.

### Reactivating the module

In some cases, it helps to deactivate and reactivate the module. This resets the module without losing your configuration settings.

1. Log in to PrestaShop.
2. Select **Modules** > **Module Manager** in the left navigation menu.
3. Use the search bar or scroll down to **Payment** to locate **PrestaShop**.
4. Select the arrow next to **Configure**.
5. Select **Reset** from the drop-down menu.

### Reinstalling the module

In some cases, the best option is to uninstall and reinstall the module.

1. Log in to PrestaShop.
2. Select **Modules** > **Module Manager** in the left navigation menu.
3. Use the search bar or scroll down to **Payment** to locate **PrestaShop**.
4. Select the arrow next to **Configure**.
5. Select **UninstalS** from the drop-down menu.
6. Install the module.

### Clear the cache

Mollie for PrestaShop stores data exchanged between Mollie and PrestaShop in a cache. Problems related to information loading can occur when the cache gets too full.

1. Log in to PrestaShop.
2. In the left navigation menu, select **Advanced parameters** > **Performance**.
3. Select **Clear cache**.