Skip to main content
Mollie supports every MagicPost plan type. Customers pay on a page hosted by Mollie. Unlike most gateways, Mollie needs no webhook set-up in its dashboard: MagicPost passes the webhook address with each payment.

​
Get your API key from Mollie

1

Sign in

Open your Mollie Dashboard and sign in.
2

Open the API keys

Go to Developers, then API keys.
3

Copy the keys

Copy the live key, which starts with live_, and the test key, which starts with test_.

​
Add the keys in MagicPost

1

Open the Mollie card

Go to Admin → Finance → Payment Gateways and click Mollie. The page is titled Mollie Settings.
2

Enable it

Under General, turn on Status, then choose Live or Sandbox under Mode.
3

Paste the keys

Under Keys, fill in:
  • Live Mollie API Key, described as “Your live API key, starts with live_”
  • Sandbox Mollie API Key, described as “Your test API key, starts with test_”
4

Save

Click Save. You see “Mollie settings saved successfully.”
Under Webhooks, the Webhook URL field is read-only. It is there so you can see the address, and Mollie needs no secret.

​
How payments work

One-time plans (Prepaid, Lifetime). MagicPost creates a Mollie payment for the plan price and redirects the customer to Mollie. On return, MagicPost fetches the payment and records the order only if Mollie reports it as paid. For Lifetime plans it also creates the subscription. Recurring plans (Monthly, Yearly). MagicPost creates a Mollie customer for the buyer and a first payment for the plan price. That first payment sets up the customer’s mandate. When the customer returns and the payment is paid, MagicPost records the order and creates a Mollie subscription that bills every month (Monthly) or every 12 months (Yearly). Mollie has no plan object, so there is nothing to create at Mollie ahead of time. Webhook. Mollie only sends a payment ID. MagicPost fetches that payment from Mollie and acts on its status:
  • A paid payment that belongs to a recurring subscription extends the subscriber’s period and renews the credit allowance.
  • A cancelled, expired or failed payment that belongs to a subscription marks the subscriber as cancelled.
Cancelling a subscriber in MagicPost does not cancel it at Mollie. Also cancel it in your Mollie Dashboard.

​
Currency

MagicPost sends the plan’s currency in uppercase and the price with two decimals. Your Mollie account must support the currency and the payment methods you want to offer.

​
Test mode

Enter your test_ key in Sandbox Mollie API Key, select Sandbox under Mode and save. Payments then run against Mollie’s test environment. Switch Mode back to Live before you sell.

​
Common errors

Status is off for Mollie. Turn it on and save.
The request to Mollie failed, usually because the API key for the active Mode is missing or wrong. Check storage/logs/laravel.log.
Mollie answered but did not open a payment, for example because the currency or payment method is not enabled on your account.
These appear for Monthly and Yearly plans when the customer or the first payment could not be created at Mollie.
The API key for the active Mode is missing, or the plan is not a Monthly or Yearly plan with a price above zero.
The customer came back in a different browser session, Mollie could not be reached, or the payment is not paid.
See also Payment gateways and Billing problems.