Skip to content
Gaurav TiwariDocs

Mollie

Version 1.0.0-beta.1 Updated November 8, 2026

Buyers in the Netherlands expect iDEAL, buyers in Belgium expect Bancontact, and everyone else wants a card, PayPal or their own bank button. Adding those one plugin at a time leaves you with a crowded checkout and subscriptions that only renew on cards.

The Mollie module sends buyers to Mollie’s hosted checkout with every method switched on in your Mollie account, with an optional method picker at checkout. Subscriptions save a card, PayPal or SEPA Direct Debit mandate and renew automatically. Every payment update is read back from Mollie before an EDD order changes.

Turn On the Gateway

  1. Switch on the Mollie module under Stackless → Dashboard.
  2. Add your API keys under Stackless → Settings → Mollie and save.
  3. Go to Downloads → Settings → Payments and switch on Mollie (Stackless) under Active Gateways. Save.

Mollie stays off the checkout until the selected mode has an API key. The gateway is in Stackless Lite for EDD too. Automatic renewals need the Subscriptions module in Stackless for EDD.

Add Your API Keys

In your Mollie Dashboard, open Developers → API keys. The link on the settings screen goes there. Copy the live key (live_) and the test key (test_) of your website profile, then fill in the Mollie account section:

  • Test mode: uses the test API key, so no real money moves. Test payments take euros only. On by default.
  • Test API key
  • Live API key

When you save, Stackless checks each key with Mollie and shows any error. A key in the wrong field, such as a live key under Test API key, shows an error too. So does switching the gateway on with no key for the selected mode.

You can also set the keys as wp-config.php constants, which win over saved settings and hide their fields: STACKLESS_EDD_MOLLIE_LIVE_API_KEY and STACKLESS_EDD_MOLLIE_TEST_API_KEY.

Why There Is No Webhook to Add

You don’t register a webhook in Mollie. Stackless sends this URL with every payment, and Mollie calls it whenever that payment changes: https://yoursite.com/wp-json/stackless-edd/v1/mollie/webhook.

Mollie’s payment webhooks carry only a payment id, with no signature. So Stackless trusts nothing in the request:

  • It reads the payment from the Mollie API with your own key, trying the order’s mode first and then the other one. Only Mollie’s answer changes an order.
  • An id Mollie doesn’t know is ignored, and so is a payment whose details name another site.
  • Each state of a payment, meaning its status plus the amounts refunded and charged back, is applied once. Repeat calls change nothing.

The buyer’s return from Mollie is checked the same way, so most orders are settled before the webhook arrives. The webhook matters for buyers who close the tab, renewals, refunds and chargebacks. Your site needs to be reachable from the internet for it to arrive.

Choose Methods and the Picker

The Checkout section has these settings:

  • Title: the payment method name at checkout. Default “Card, iDEAL, Bancontact or PayPal”.
  • Description: shown with the payment fields. Default “You’ll finish paying on Mollie’s secure checkout.”
  • Methods to offer: leave it empty to offer every method switched on in Mollie for the order’s currency and amount, or pick a shorter list. Subscriptions only see methods that can save a mandate. Empty by default.
  • Method choice: “Let buyers pick the method at checkout, then go straight to it” (default) or “Let buyers pick on Mollie’s page”.
  • Saved payment methods: lets signed-in customers save cards, PayPal and bank mandates for later. Subscription orders always save the method. On by default.

With the picker at checkout, buyers see a Payment method dropdown with the methods Mollie offers for that cart, starting with “Choose on the next page”. Picking one sends them straight to that method on Mollie. The list is cached for six hours, so a method you switch on in Mollie can take that long to show.

What Buyers See

  • Clicking Purchase sends the buyer to Mollie’s checkout in your site’s language, with their name, email and billing address passed along. After paying, they come back to your EDD success page.
  • Cancelling on Mollie’s page brings them back to checkout with the order. A declined or unfinished payment shows a message there so they can try again. Purchasing again reuses a Mollie payment that’s still open.
  • Signed-in customers with saved methods see them as a list, with “Use a new payment method” at the end. A saved method is charged without leaving your site.
  • With Saved payment methods on, signed-in customers also get a “Save this payment method for future purchases” box. Subscription checkouts say “This payment method is saved with Mollie for future payments.” instead.
  • A payment Mollie reports as still processing moves the order to Processing until Mollie confirms it.
  • Pay-later methods such as Klarna are only authorized. The order goes on hold with a note to capture the payment in Mollie.
  • A payment for a different amount or currency than the order puts it on hold with a note to check it.
  • Test mode adds “Test mode: no real payment will be taken.”

Mollie shows for the currencies it accepts, such as EUR, GBP, USD, CHF, PLN and SEK, and hides itself for others. In test mode it shows for euros only.

Subscriptions on Mollie

A subscription checkout is a first payment on a Mollie customer, which leaves a mandate for later charges. Only methods that can create a mandate are offered.

Paid at checkout withSaved asRenews in
Card, Apple Pay or Google PayCard mandateAny currency Mollie takes
PayPalPayPal mandateAny currency Mollie takes
iDEAL, Bancontact, Belfius, EPS, KBC/CBC, MyBank or Pay by BankSEPA Direct Debit mandateEuros only

On the due date, Stackless creates the renewal order and charges the mandate without the customer present. Card charges usually come back paid straight away. SEPA Direct Debit settles a few days after the charge, so that renewal order stays pending with a note until the webhook settles it.

  • If Mollie can’t be reached, the charge is retried up to 3 more times, 15, 30 and 45 minutes apart.
  • A declined charge marks the renewal order Failed with Mollie’s reason, and your retry schedule takes over. Renewals, Failed Payments and Retries covers what happens next.
  • A free trial with nothing to pay today still offers Mollie and saves the method. When the payment can only use a card or PayPal, for example because the buyer picked one at checkout, Mollie takes a 0.00 payment. Otherwise it takes one cent, the smallest amount in the currency, which Stackless refunds once Mollie confirms the mandate.
  • Customers can change a subscription’s payment method from the subscription portal.

Saved Methods

  • Customers see their saved methods in the Mollie section of the Payment methods tab on the account page. They can make one the default or delete it.
  • Add a payment method with Mollie takes them to Mollie’s page to confirm a method. It’s a first payment of 0.00 or one cent, and the cent is refunded once Mollie confirms the method.
  • Deleting a saved method revokes the mandate at Mollie, so it can’t be charged again.
  • Saved methods also pay for Post-purchase Offers.
  • Test and live mandates are kept apart, so a test mandate never shows in live mode.

Refunds and Chargebacks

Refund from the EDD order screen, in full or in part. The refund form gets a Refund the payment in Mollie box, ticked by default. Mollie is called before EDD records the refund, so a refund Mollie refuses stops there with the error. Untick the box to record the refund in EDD only.

Refunds made in the Mollie Dashboard are recorded on the order when Mollie reports the payment. A refund Mollie can’t complete adds a note.

A chargeback adds a note with the amount. A Complete or Partially Refunded order is also put on hold through EDD’s own dispute record, which pauses file access until you change the status.

Billing Health

Mollie reports to Billing Health: a missing API key for the selected mode, test mode, charges on saved methods still pending after two weeks and webhook calls that failed recently. Mollie retries a failed call for about a day.

Limits

  • SEPA Direct Debit renewals settle a few days after the charge, and bank mandates renew in euros only.
  • Test mode takes euros only, so Mollie hides itself for other currencies while test mode is on.
  • Pay-later methods leave the order on hold until you capture the payment in Mollie.
  • Methods that can’t create a mandate, such as Klarna or bank transfer, can’t pay for subscriptions.
  • If Mollie doesn’t return a usable mandate, the order is still paid, and its renewals are invoiced instead of charged.
  • A refund made in the Mollie Dashboard that EDD can’t spread over the order’s items marks the order Partially Refunded with a note, without an EDD refund record.
  • On a site Stackless treats as a copy of the live store, such as a staging clone, saved payment methods aren’t charged.
  • Mollie can’t be duplicated with Payment Gateway Tools. Its mandates and customers belong to one Mollie account.
  • Turn on Debug log under Advanced to write Mollie activity to Downloads → Tools → Debug Log, tagged stackless-edd-mollie_gateway. Errors are always logged. Keys never are.

For Developers

stackless_edd_mollie_gateway_currencies narrows the currency list Mollie shows for:

add_filter('stackless_edd_mollie_gateway_currencies', function ($currencies) {
    return ['EUR', 'GBP'];
});

Return false from stackless_edd_mollie_gateway_chargeback_sets_on_hold to keep orders as they are when a chargeback arrives. stackless_edd_mollie_gateway_webhook runs after each webhook is applied, with the payment as Mollie returned it and the mode. Refunds created in code reach Mollie only when stackless_edd_refund_at_gateway returns true. Copy a template from templates/mollie_gateway/ to yourtheme/stackless-edd/mollie_gateway/ to change the checkout fields or the account section.

Share

Was this helpful?

Still stuck? Open a support ticket