Skip to content

Set up Mollie

The Mollie gateway takes payments on Mollie’s own payment page, with the payment methods you turned on in your Mollie dashboard (cards, iDEAL, Bancontact, SEPA, PayPal and others). A client can save a card or bank account there, and their invoices are then charged to it automatically, as with PayTabs and Stripe’s saved cards.

  • The API key. In your Mollie dashboard, open Developers → API keys. The live key starts with live_, the test key with test_.
  • Saved payment methods need recurring payments on your Mollie account. If Mollie has not enabled them, turn off Saved payment methods: clients then pay each invoice on Mollie’s page.
  • Pay-later methods that need a manual capture, such as Klarna, are not supported. Do not turn them on for the website that uses this portal.
  1. Install Mollie on System → Payment Gateways and open it.
  2. Paste the live key into Live API key.
  3. Turn on Enabled and select Update Gateway. ClientFence checks the key with Mollie before it saves it.

ClientFence gives Mollie its return and webhook addresses with each payment, so there is nothing to set in the Mollie dashboard. Mollie’s webhook only names the payment: ClientFence reads each payment back from Mollie before it records anything.

Turn on Test mode, paste the test key into Test API key, and pay an invoice. Mollie’s test payment page lets you choose whether each payment is paid, failed or expired.

Setting What it does
Saved payment methods Clients can save a card or bank account at Mollie and their invoices are charged to it automatically (on by default). Off: the invoice offers only Pay now on Mollie’s page, and the settings below have no effect.
Pay with the saved payment method A Pay now with button on the invoice that pays at once (on by default).
Pay once without saving A Pay once button (on by default). Off: clients can only pay by saving a payment method.
Set up on the Payment methods page Clients save a payment method without paying an invoice (on by default).
Free orders After a free order that renews, such as a free trial, a client without a saved payment method goes to Mollie to save one (on by default).

On the invoice, the account owner selects Pay and set up automatic payments, or, once a payment method is saved, Pay now with it. Anyone with the invoice can select Pay once. The saved method is charged as a recurring payment, as described in Saved cards and PayPal accounts. Staff can charge it now with Charge on the invoice.

Some payments, such as SEPA Direct Debit, take a few days. Until Mollie confirms one, the client’s invoice shows Payment pending: no second payment starts, and reminders and suspension wait.

A failed charge emails the client with a link to pay the invoice. Removing the saved method on the Payment methods page removes it from ClientFence and revokes it at Mollie.

When Mollie reports a chargeback on a paid payment, ClientFence takes it back as it does a Stripe dispute: the payment comes off the invoice, and the services it renewed go back by their period.

When you refund an invoice paid with Mollie, choose Send it back through Mollie (see Refunds). The refund is recorded only when Mollie accepts it.