Aan de slag
Zes stappen van "geen Mollie" naar "eerste factuur betaald via iDEAL".
Stap 1 — Meld u aan bij mollie.com
Maak een Mollie-account op mollie.com. De gratis aanmelding loopt door Mollies KYC (KvK-check, ID-upload, bankrekening-verificatie). Reken op 1–2 werkdagen voor volledige activatie; sandbox / testmodus werkt direct.
U krijgt API-sleutels (een live-sleutel en een test-sleutel) in
uw Mollie-dashboard onder Developers → API keys. De sleutels
beginnen met live_ of test_.
Stap 2 — Activeer betaalmethoden in uw Mollie-dashboard
Onder Settings → Payment methods, activeer de methoden die u wilt aanbieden. De belangrijkste voor Nederlands zakendoen:
- iDEAL — standaard geactiveerd.
- Credit cards — vereist een aparte acquiring-overeenkomst (Mollie meldt u aan); duurt een paar dagen.
- SEPA-incasso — vereist een geverifieerde IBAN; voor terugkerende abonnementen.
- Bancontact — voor Belgische klanten.
- Apple Pay — vereist domeinverificatie (Mollie loodst u door).
U kunt methoden te allen tijde activeren / deactiveren; wijzigingen zijn meteen van kracht.
Stap 3 — Installeer de app
bench --site <uw-site> install-app mollie_integration
Herstart de bench zodat Mollie Settings in de zoekbalk verschijnt.
Stap 4 — Configureer Mollie Settings
Open Mollie Settings in de zoekbalk (single doctype — er bestaat maar één record per site).
| Veld | Wat in te vullen |
|---|---|
| Profile ID | Uit Mollie-dashboard → Profiles → uw profiel. Ziet eruit als pfl_xxxxxx. |
| Secret Key | De live_*-API-sleutel voor productie, of test_* tijdens testen. |
| Payment URL Type | Create on Click (standaard) — links vervallen nooit. Create Immediately — voor cart-checkout waar de klant direct betaalt. |
| Default Method | Leeg laten om Mollie de volledige methode-keuze te laten tonen. Of kies ideal om direct naar iDEAL door te springen. |
| Webhook Secret | Auto-gegenereerd bij opslaan. Gebruikt om binnenkomende webhooks van Mollie te verifiëren. |
Opslaan. De webhook-URL is nu <uw-site>/api/method/mollie_integration.mollie.api.webhooks.
Stap 5 — Test in sandbox-modus
Met een test_*-Secret Key in Mollie Settings:
- Maak een concept-Verkoopfactuur.
- Dien hem in.
- Klik in het menu van de factuur op Get Payment Link (of hang er een Payment Request aan).
- Open de link in een incognito-tabblad.
- Kies iDEAL → kies "Test bank" → kies "Paid"-status.
- Bekijk de Verkoopfactuur — binnen seconden moet er een Betaling zijn aangemaakt en de factuur op Betaald staan.
Verschijnt de Betaling niet, check dan Integration Request List voor de webhook-ontvangst — er staat doorgaans een duidelijke fout.
Stap 6 — Schakel over naar live-modus
Zodra de testflow werkt:
- Vervang de
test_*-Secret Key in Mollie Settings door uwlive_*-sleutel. - Verifieer dat uw webhook-URL bereikbaar is vanaf het publieke internet (Mollie moet ernaartoe POSTen). Press-deploys regelen dit automatisch; kale bench-installaties hebben een HTTPS-reverse-proxy nodig.
- Stuur een echte €0,01-testbetaling naar uzelf voordat u breed gaat — goedkope verzekering.
Wat volgt
- Betalingen ontvangen — de volledige flow voor factuurbetaling, web-shop-checkout en QR-codes.
- Abonnementen — terugkerende facturatie met machtigingen.
- Terugbetalingen — terugbetalingen initiëren wanneer nodig.