WooCommerce Mollie

Overview ↑ Back to top

Note: WooCommerce Mollie is no longer for sale on WooCommerce.com, and documentation is not being updated. Current users can continue using it without disruption until the end of their subscription. New users can use Stripe, which is free and offers support for many of the same payment methods as Mollie.

Mollie is a gateway plugin that extends WooCommerce and allows you to accept payments with iDEAL, Credit Card, Mister Cash, bank transfers, PayPal, PaySafeCard, Belfius Direct Net, and SOFORT via Mollie.


WooCommerce Mollie Payment Methods
Checkout Form

When an order is placed, the customer chooses their payment method, and is taken to Mollie to complete the payment process. If the customer chooses iDEAL, the customer is redirected to the bank of their choice to make a secure payment via Mollie. Because Mollie handles the payment process for you, no SSL certificate is required on your site (only for this integration; other rules may apply for your shop/checkout in your country).


Installation ↑ Back to top

  1. Download the extension from your dashboard
  2. Go to Plugins > Add New > Upload and select the ZIP file you just downloaded
  3. Click Install Now, and then Activate
  4. Go to WooCommerce > Settings > Payments > Mollie and read the next section to learn how to setup and configure the plugin.


Setup and Configuration ↑ Back to top

First, we’ll need to set up your Mollie account. Log in to your Mollie account and follow these steps:

    1. Click on “Website Profiles” (Websiteprofielen) under “My Account” (Mijn account).
    2. Under this menu, you’ll need to look at your website profile details, or create a new website profile if you don’t have one. Click on the appropriate button.
WooCommerce Mollie Create or Update a Website Profile
Create or Update a Website Profile
    1. If you’re creating a new website profile, enter your store’s details on the next page, including your website URL and company name, and continue. If you already have a website profile, skip to the next step after you’ve clicked on “Details” for your profile.
    2. Your website profile page has all of the information needed to integrate your Mollie account with the WooCommerce Mollie extension. First, copy your Live or Test API key (depending on the environment you’re using) and save it in the plugin settings page.
WooCommerce Mollie API keys and webhooks
WooCommerce Mollie API keys and webhooks
  1. Then, copy the webhook from the plugin settings page. It should be something like this: http://YOUR-SITE.com/?wc-api=WC_Gateway_Mollie, but will have your store’s URL, or will suggest https:// instead of http:// if available.Save this webhook URL for the Live and Test webhook values in your Mollie account.
  2. Now click “Payment Methods” (Betaalmethodes nieuw) under My Account. Select the payment methods you want to accept , follow the steps given to enable them, and save these changes in your Mollie admin. The plugin will automatically display the appropriate options on the checkout page.
    WooCommerce Mollie Select Accepted Payment Methods
    Select Accepted Payment Methods

    WooCommerce Mollie Checkout Experience
    Mollie Checkout Experience

Please Note: When using the iDEAL payment method, a dropdown list will be shown for the customer to select a bank if there’s more than one bank available for their account. If only one bank is available, that bank will be used by default.

Configuration ↑ Back to top

Once your Mollie account is set up, go to your wp-admin WooCommerce > Settings > Payments > Mollie to finish setup.

WooCommerce Mollie Admin Settings
Mollie Admin Settings

Extension Settings ↑ Back to top

  • Enable/Disable – This will enable the gateway to be used by customers to checkout.
  • Title – This displays the title that the customer will see at checkout. The special string {method title} will be substituted for the current Mollie method name (iDEAL, Credit Card, Mister Cash, etc).
  • Description – This is the description of the payment method that customers will see at checkout. Limited HTML is allowed. The special string {method title} will be substituted for the current Mollie method name (iDEAL, Credit Card, Mister Cash, etc).
  • Environment – Enable Production (live) or Test mode for transactions.
  • Available Methods – The payment methods available for checkout; these are configured in your Mollie account and will show up once you’ve entered and saved your API key.
  • Live API key – This is your Mollie website profile Live API key.
  • Test API key – This is your Mollie website profile Test API key.
  • Live / Test Webhook Configured – Check this setting to ensure that you’ve saved the Webhook to your Mollie profile. To properly process transactions, you must configure your Mollie account Web Site Profile live / test Webhook to the following: http://YOUR-SITE.COM/?wc-api=WC_Gateway_Mollie
  • Debug Mode – Enable this is you are having issues correctly processing transactions. You can either log API requests / responses directly to the checkout / thank you page, save them to the WooCommerce Error Log, or both. All debugging messages are cleaned of sensitive information before display, but as a best practice, please do not enable this unless you are having issues with the plugin.


Upgrading to 2.0 ↑ Back to top

Between these versions, WooCommerce Mollie was rewritten to take advantage of the new Mollie API, so a completely new configuration is now required. Follow the full setup instructions to reconfigure the extension using the new Mollie system, or read these abbreviated steps:

If you are updating your WooCommerce Mollie extension, you will have to log into your Mollie account and generate the new API key under “Website Profiles” to replace the Partner ID, then set the Webhook URL before you can start accepting payments again.

The Webhook URL that you’ll save in your Mollie account is this: http://YOUR-SITE.COM/?wc-api=WC_Gateway_Mollie. Replace YOUR-SITE.COM with your site’s URL instead. You can simply copy this from the plugin settings page.


Troubleshooting ↑ Back to top

Having trouble? Follow these steps to make sure everything is setup correctly before posting a support request:

  1. Check that your Live API key is correct.
  2. If you just updated to version 2.0, make sure you’ve followed upgrading steps.
  3. Make sure all issues in your Mollie account dashboard are resolved and that you are ready to accept payment.
  4. Make sure your store is set to use Euro as the currency.
  5. The minimum transaction amount for Mollie is €1,20.
  6. Once you’ve checked these items, please log in and submit a support ticket.


Frequently Asked Questions ↑ Back to top

Q: Does this Mollie integration support Mister Cash?
A: Starting with version 2.0, WooCommerce Mollie now supports all payment methods available using the Mollie API, which includes Mister Cash support. Please follow the upgrading guidelines to upgrade to the newest version and get access to these awesome features!

Q: Can I re-order the display of my Mollie payment methods at checkout?
A: Yes! You can use this sample snippet to do so – simply re-order the payment methods into the order of your choice, and insert this in the Code Snippets plugin or your child theme’s functions.php file:

function wc_mollie_reorder_gateways( $gateways ) {
$gateway_order = array(
// Rearrange these payment options into the order you wish
return array_intersect( $gateway_order, $gateways );
add_filter( 'wc_gateway_mollie_gateways', 'wc_mollie_reorder_gateways' );


For Developers ↑ Back to top

With the help of a developer, Mollie can support the Payment Gateway Based Fees plugin to let you set a fee for each Mollie payment method supported.

To do so, you can download our starter plugin. This can be installed as-is, and uses the default Mollie fees for each payment method.

To use a custom fee structure, the starter plugin needs to be modified (we do not support this customization). You’ll need to adjust the output text, determine what kind of fee to use with the addvaluetype key, and add your values for this fee.


WooCommerce - the most customizable eCommerce platform for building your online business.

Back to the top