Mollie Payments

Mollie Payments for WooCommerce enables you to offer global and local payment methods, with support in your language.

Ensure that your site is using the following:

• PHP 7.2 or later.
• WordPress 3.8 or later.

The following PHP extensions should be enabled:

• Client URL Library (cURL)
• JavaScript Object Notation (JSON)

Note: As of PHP 8.0.0, JSON is a core PHP extension, bundled and compiled into PHP by default — it is always enabled.

If you are unsure whether you have cURL or JSON enabled, please contact your hosting company.

To receive payments via Mollie, you need to sign up for a Mollie account. If you already have an account, please continue to step two. 

You can install Mollie Payments on your site automatically or manually. (We recommend choosing one of the automatic options.)

Mollie provides two API keys for authenticating requests:

• Test API key: Use this key when setting up and testing Mollie.
• Live API key: Use this key once Mollie approves your account and you are ready to accept live payments.

To connect your WooCommerce store with Mollie, follow these steps:

1. Log in to your Mollie account dashboard.
2. Select your organization in the top-left corner of the dashboard’s home page.
   

   Important: UK-based merchants must select a UK-registered organization to comply with regulations and ensure they use the correct API keys.

3. Go to More > Developers > API keys.
4. Copy the API keys.
5. Log in to your site’s WP Admin dashboard.
6. Navigate to WooCommerce > Settings.
7. Click the Mollie Settings tab.
8. Paste the API keys into their respective fields.
9. Select the Enable test mode checkbox. We recommend enabling test mode until you are sure that everything works as expected.
10. Click Save changes.
11. Refresh your browser to retrieve the most recent data from Mollie.

Note: For full installation instructions, please refer to our guide to Mollie Payments for WooCommerce.

Need more help? Join the Mollie developer community on Discord to connect with Mollie’s product and engineering teams and get technical support from other community members.

You can use code snippets to:

• Add custom information to Mollie’s payment object metadata.
• Remove the notice in emails with uncertain payment status.
• Change the Payment completed by text on the return page.

Note: These code snippets are provided by individual users, not Mollie or WooCommerce. We advise that you test them on a staging/sandbox environment first. Use at your own risk.

Mollie Payments for WooCommerce gives you the option to use either the Payment or Order API. Mollie no longer recommends using the Order API — please use the Payment API instead.

To switch APIs:

1. In your WP Admin dashboard, navigate to WooCommerce > Settings > Mollie Settings.
2. Click the Advanced Settings tab.
3. From the Select API Method dropdown, select the Payment option.
4. Click Save changes.

Learn about the differences between the Payment and Order APIs.

To troubleshoot these errors, you’ll need to first enable WordPress debugging mode:

1. Connect to your site using Secure File Transfer Protocol (SFTP).
2. Open the file named wp-config.php.
3. Look for the following line of code:
   

   define('WP_DEBUG', false);

4. Change the value from false to true.
5. On the next line below, add the following code:
   

   define('WP_DEBUG_LOG', true);

   
   You must add this above the line:
   

   /* That's all, stop editing! Happy publishing. */

6. Save the file.
7. Refresh the page you saw the error on; when Mollie Payments for WooCommerce triggers an error, the error will be logged at /wp-content/debug.log. Please check this file for errors.

Once you’re finished troubleshooting, don’t forget to turn off debug mode by setting the values for WP_DEBUG and WP_DEBUG_LOG back to false before saving your wp-config.php file.

Learn more about debugging in WordPress.

1. In your WP Admin dashboard, navigate to WooCommerce > Settings.
2. Click the Payments tab.
3. Under Payment methods, check which Mollie payment methods are active via the Enabled toggle.
4. If a Mollie payment method is disabled, click the Manage button next to it to view its settings and troubleshoot.

Yes — here’s how:

1. In your WP Admin dashboard, navigate to WooCommerce > Settings > Mollie Settings.
2. Click the Advanced Settings tab.
3. In the Currently Active Payment Methods section, next to the payment method you’d like to edit, click Manage Payment Method.
4. From the Payment surcharge dropdown menu, select the type of fee type you’d like to add:
   • No fee
   • Fixed fee
   • Percentage
   • Fixed fee and percentage
5. Next, specify the fee amounts and limits.
6. Click Save changes.

Yes — here’s how:

1. In your WP Admin dashboard, navigate to WooCommerce > Settings > Mollie Settings.
2. Click the Advanced Settings tab.
3. In the Currently Active Payment Methods section, next to the payment method you’d like to edit, click Manage Payment Method.
4. In the Sell to specific countries field, select the countries where you’d like the payment method to appear.
5. Click Save changes.

Please contact info@mollie.com with your Mollie partner ID, describing your problem in as much detail as possible. Include screenshots where appropriate and, if possible, include the Mollie log file.

You can find Mollie log files on your server at: /wp-content/plugin/woocommerce/logs or /wp-content/uploads/wc-logs/.