Mollie Payments

Installation

↑ Back to top

Step 1: Create a Mollie account

↑ Back to top
  1. To receive payments via Mollie, you need a Mollie account. Please continue with step 2 if you already have an account. 
  2. Ensure that you use these package versions:
    • PHP 7.2 or later
    • WordPress 3.8 or later
  3. Ensure that you have these PHP extensions enabled: cURL, JSON.

Step 2: Install Mollie on your WordPress website

↑ Back to top
  1. Log in to WooCommerce.
  2. Go to Plugins > Add New.
  3. Search for Mollie Payments for WooCommerce.
  4. Select Install now on the Mollie Payments for WooCommerce pane.
  5. In the pane, select Activate now.

Step 3: Connect Mollie to your WooCommerce store

↑ Back to top

Mollie gives you two API keys to authenticate your requests:

  • Test key: Use this key when setting up and testing Mollie.
  • Live key: Use this key after Mollie has approved your account and you are ready to accept live payments.

To connect with Mollie, follow these steps:

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

    ❗️ Important
    To comply with UK regulations, UK-based merchants have to select a UK-registered organization to ensure that they use the correct API keys.

  3. Go to More > Developers > API keys.
  4. Copy the API keys.
  5. Log in to WooCommerce.
  6. Open WooCommerce > Settings.
  7. Select 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. Save the changes.
  11. Refresh your browser to retrieve the most recent data from Mollie.

Note

↑ Back to top

For the full installation instructions, please refer to our Mollie for WooCommerce guide.

Need further help? Join the Mollie Developer Community on Discord to connect with our product and engineering teams and get technical support from other community members.

Helpful snippets

↑ Back to top

You can customise your plugin with these helpful snippets.

Which ‘API Method’ should I use?

↑ Back to top

Within the Mollie settings is the option to use either the ‘Payment’ or ‘Orders’ API, although Mollie no longer recommends implementing the Orders API.
Please refer to the Payments API instead

You can switch to the ‘Payments API’ directly from the extension settings, via: 
WP Dashboard > WooCommerce > Settings > Mollie Settings > Advanced > Select API Method.

Click here to read more about the differences between the Payments and Orders API

Frequently Asked Questions

↑ Back to top

I can’t install the plugin, the plugin is displayed incorrectly

↑ Back to top

Please temporarily enable the WordPress Debug Mode. Edit your wp-config.php and set the constants WP_DEBUG and WP_DEBUG_LOG to true and try it again. When the plugin triggers an error, WordPress will log the error to the log file /wp-content/debug.log. Please check this file for errors. When done, don’t forget to turn off the WordPress debug mode by setting the two constants WP_DEBUG and WP_DEBUG_LOG back to false.

The Mollie payment gateways aren’t displayed in my checkout

↑ Back to top
  • Please go to WooCommerce -> Settings -> Payments in your WordPress admin and scroll down to the Mollie settings section.
  • Check which payment gateways are disabled.
  • Go to the specific payment gateway settings page to find out why the payment gateway is disabled.

Can I add payment fees to payment methods?

↑ Back to top

Yes, you can within the plugin, click on a payment gateway and set up what kind of payment surcharge you would like to add to the payment gateway.

Can I set up payment methods to show based on the customer’s country?

↑ Back to top

Yes, you can within the plugin, click on a payment gateway and set up in which countries this payment gateway should be visible.

I have a different question about this plugin

↑ Back to top

Please contact info@mollie.com with your Mollie partner ID, please describe your problem as detailed as possible. Include screenshots where appropriate.

Where possible, also include the Mollie log file. You can find the Mollie log files in /wp-content/plugin/woocommerce/logs or /wp-content/uploads/wc-logs/.

Use of your personal data
We and our partners process your personal data (such as browsing data, IP Addresses, cookie information, and other unique identifiers) based on your consent and/or our legitimate interest to optimize our website, marketing activities, and your user experience.