Mollie is a European payment provider available with Fundations Pro. It supports 13 local and international payment methods and is particularly strong in the Netherlands, Belgium, Germany, and Austria.
You must have an active Fundations Pro license to process payments through Mollie. The settings fields appear in the free plugin, but without Pro the form returns an error at checkout.
Why use Mollie
Mollie covers the widest range of European payment methods in a single integration. iDEAL for Dutch donors, Bancontact for Belgian donors, SEPA Direct Debit for recurring mandates, and card payments all work under one Mollie account. If your campaign targets a European audience, Mollie is the recommended choice.
What it does
When a donor selects a Mollie payment method and submits the donation form:
- Fundations Pro creates a payment via the Mollie API (
api.mollie.com/v2/payments). - The donor is redirected to Mollie’s hosted checkout.
- The donor completes payment with their chosen method.
- Mollie sends a webhook to your site with the payment status.
- Fundations fetches the full payment record from Mollie to confirm the status, then marks the donation as paid, updates the fundraiser total, and sends the confirmation email.
- Mollie also redirects the donor back to your site’s thank-you page.
How to set up Mollie
Step 1: Create a Mollie account
Sign up at mollie.com/signup. Complete business verification, bank account verification, and website verification in the Mollie dashboard. Mollie will not activate your live account until verification is complete.
Step 2: Enable payment methods in Mollie
In the Mollie Dashboard, go to Settings → Website profiles → Payment methods and enable the methods you want to offer. Only methods you enable in Mollie will appear in Fundations, regardless of what you configure on the WordPress side.
Step 3: Get API keys
- In the Mollie Dashboard, go to Developers → API Keys.
- Copy the Live API key (
live_...) and the Test API key (test_...).
Step 4: Configure in WordPress
- In your WordPress admin, go to Fundations → Settings → Mollie.
- Paste the Live API key and Test API key.
- Set the mode to Test while you verify the setup.
- Click Test Connection to confirm Fundations can reach the Mollie API.
- Click Save Changes.
Step 5: Configure payment methods (optional)
After saving your API keys, click Refresh Methods in the settings to fetch the current list of enabled methods from Mollie. Fundations caches this list for 24 hours.
You can drag methods to reorder how they appear on the donation form, and upload a custom logo for any method to replace the default Mollie icon.
Step 6: Configure the webhook
The Mollie webhook URL is configured automatically. Mollie sends payment status updates to:
https://yoursite.com/wp-json/get-fund/v1/mollie-webhookThis URL is set by Fundations when creating each payment. You do not need to register it manually in the Mollie Dashboard, but you can verify it under Mollie Dashboard → Developers → Webhooks to confirm it appears.
The webhook URL must be publicly reachable over HTTPS. Local or staging sites without a public URL will not receive webhooks.
Step 7: Test your setup
- Confirm mode is set to Test in Fundations settings.
- Make a donation on your site and select a payment method (for example, iDEAL).
- Mollie’s test interface will appear. Select Paid to simulate a successful payment.
- Verify the donation shows as paid in Fundations → Donations.
- Check that the fundraiser’s raised amount updated.
- Switch to Live mode when ready.
Payment methods
| Method | Primary region | Slug |
|---|---|---|
| iDEAL | Netherlands | ideal |
| Credit card | Global | creditcard |
| Bancontact | Belgium | bancontact |
| SEPA Direct Debit | Europe | directdebit |
| PayPal (via Mollie) | Global | paypal |
| Apple Pay | Global | applepay |
| Google Pay | Global | googlepay |
| SOFORT | Germany, Austria | sofort |
| Giropay | Germany | giropay |
| EPS | Austria | eps |
| Przelewy24 | Poland | przelewy24 |
| Belfius | Belgium | belfius |
| KBC | Belgium | kbc |
A method only appears if it is enabled in your Mollie account and your account has been verified for that method.
Settings reference
| Option | Description |
|---|---|
| Enable Mollie | Turns Mollie on or off on the donation form. |
| Mode | Switch between Test and Live. |
| Live API key | From Mollie Dashboard → Developers → API Keys. Starts with live_. |
| Test API key | Sandbox key for testing. Starts with test_. |
| Methods order | Drag-and-drop order of payment methods on the donation form. |
| Logo per method | Custom image URL to replace the default method icon for each of the 13 methods. |
Capabilities and limits
You can accept 13 local and international payment methods, reorder methods, and replace method icons with your own logos. Mollie can run alongside PayPal at the same time. The Test Connection button verifies your API key without making a real transaction, and you can refresh the cached method list on demand.
There are also hard limits. You cannot process payments without Fundations Pro and an active license. Mollie will not work on a site that is not publicly reachable, because webhooks will not arrive. Recurring donations are currently disabled in the plugin. On the security side, Fundations always re-fetches the payment from the Mollie API when a webhook arrives, so a forged webhook cannot mark a donation as paid.
Troubleshooting
Payment methods do not appear on the donation form. Click Refresh Methods in Fundations settings to pull the current list from Mollie. If methods still do not appear, confirm they are enabled in the Mollie Dashboard under Settings → Website profiles → Payment methods. The cached list expires after 24 hours.
Donations stay in “pending” after the donor returns from Mollie. This usually means the webhook did not arrive. Confirm that your site is publicly reachable at https://yoursite.com/wp-json/get-fund/v1/mollie-webhook. Use the Mollie Dashboard under Developers → Webhooks to see if delivery failed and retry it.
“Test Connection” fails. Double-check that you pasted the correct key for the selected mode: the test key (test_...) must be in the Test API key field and the live key (live_...) in the Live API key field. Do not swap them.
No methods appear after refreshing. Your Mollie account may not have been verified for any payment methods yet, or you are using a test key that has no methods configured. Check the Mollie Dashboard to confirm methods are enabled.
Duplicate webhook processing concerns. Fundations applies a 60-second lock per payment ID when a webhook arrives. If Mollie retries delivery within that window, the second attempt is silently ignored. This is by design.
Developer reference
Payment status actions
| Action | Signature | When fired |
|---|---|---|
get_fund_donation_status_transition | ( int $donation_id, string $new_status, string $old_status ) | Every status change: paid, cancelled, failed. |
get_fund_donation_paid | ( int $donation_id ) | When Mollie confirms status is paid. Use this for post-payment steps like updating CRM records. |
get_fund_donation_completed | ( int $donation_id, array $data ) | After get_fund_donation_paid, with donor and amount data. $data keys: amount, action_id, donor_name, donor_email. |
Filters
| Filter | Signature | Purpose |
|---|---|---|
get_fund_mollie_payment_methods | ( array $methods ) | Returns available Mollie methods. PRO hooks in and returns the cached Mollie API result. Each entry: ['id' => string, 'name' => string, 'image_1x' => url, 'image_2x' => url, 'image_svg' => url]. |
get_fund_donation_redirect_url | ( string $return_url, int $donation_id ) | Filters the URL Mollie redirects the donor to after checkout. Applied in the Mollie path only. |
Refreshing the methods cache
The Mollie method list is cached for 24 hours in a transient (get_fund_mollie_methods). To refresh it programmatically:
delete_transient( 'get_fund_mollie_methods' );The next donation form load will fetch fresh data from the Mollie API.
REST endpoint
| Method | Route | Purpose |
|---|---|---|
| POST | /wp-json/get-fund/v1/mollie-webhook | Receives payment status updates from Mollie. Fundations re-fetches the payment from the Mollie API to verify the status before acting. |
Webhook verification: Mollie does not use a shared secret. The webhook handler always re-fetches the full payment object from the Mollie API using the payment ID from the POST body. A forged request that does not match a real Mollie payment ID will fail to retrieve a valid payment and be ignored.