Betalingen ontvangen

Drie primaire manieren waarop klanten u via Mollie betalen. Elk past bij een andere situatie.

A. Payment Request op een gemailde factuur

Het gangbaarste patroon voor B2B. U mailt een Verkoopfactuur; de mail bevat een betaallink; de klant klikt om te betalen.

Open de Verkoopfactuur → klik Create Payment Request.
ERPNext maakt een Payment Request gekoppeld aan de Verkoopfactuur.
Klik Get Payment URL op de Payment Request. ERPNext retourneert een URL zoals:

https://<uw-site>/api/method/mollie_integration.mollie.api.pay?doctype=Payment Request&docname=PR-00001
Gebruik Email vanaf het Payment Request-formulier (of plak de URL in een mail / bericht). De link is persistent — vervalt niet, wordt niet oud, en weerspiegelt altijd het huidige openstaande bedrag.
Wanneer de klant klikt, maakt ons pay-endpoint ter plekke de Mollie-betaling aan met het huidige openstaande bedrag van de factuur, en stuurt de klant door naar Mollies checkout.
Na betaling stuurt Mollie een webhook naar ons endpoint; wij maken de Betaling aan en zetten de factuur op betaald.

Waarom dit de standaardmodus is. Klanten negeren mails soms wekenlang. Met Create on Click werkt de URL twee maanden later nog — de betaling wordt op klikmoment gemaakt. Vergelijk Create Immediately-modus hieronder.

B. QR-code op een geprinte factuur

Zelfde flow als A, maar de URL is als QR-code in de geprinte factuur ingebed.

Op de Verkoopfactuur, zoek de QR-code-sectie in het printformaat (de Mollie-integratie voegt een printformaat-snippet toe die u kunt opnemen).
Print en verstuur de papieren factuur; de QR-code staat erop.
Klant scant, landt op Mollies checkout via hetzelfde pay-endpoint.

Handig voor B2C in branches waar papieren facturen nog gangbaar zijn (juridisch, zorg, sommige retail).

C. Web Shop-checkout (directe betaling)

Voor ERPNext Web Shop willen klanten meteen afrekenen, niet na een mail-rondje. Zet Payment URL Type op Create Immediately in Mollie Settings:

Klant vult winkelmandje en klikt op Checkout.
ERPNext maakt de Verkooporder + Payment Request.
De integratie roept direct Mollies API aan om een betaling te maken.
Mollie retourneert een checkout-URL zoals https://checkout.mollie.com/pay/xxx.
Klant wordt direct doorgestuurd.
Na betaling komt de webhook aan en gaat de Verkooporder / Verkoopfactuur naar Betaald.

Afweging: de Mollie-checkout-URL vervalt na een kort venster (doorgaans enkele uren). Voor cart-checkout is dat prima — klanten betalen direct. Voor gemailde facturen, gebruik Create on Click (modus A).

Hoe de Betaling wordt aangemaakt

Ongeacht welke invoermodus u gebruikt, is de eindstand hetzelfde:

Klant rondt Mollie-checkout af.
Mollie POSTet naar uw webhook-endpoint met de betaalstatus.
De integratie valideert de webhook-handtekening.
Bij paid-status maakt de integratie een ERPNext-Betaling aan die naar de Verkoopfactuur verwijst (of de Verkooporder → Verkoopfactuur → Betaling-keten).
Het openstaande bedrag van de Verkoopfactuur wordt bijgewerkt; de status gaat naar Betaald zodra het volledig is gedekt.

U maakt de Betaling niet handmatig. De integratie doet het bij ontvangst van een geldige webhook.

Wat u in het Mollie-dashboard ziet

Elke betaling in uw Mollie-dashboard mapt naar één ERPNext-Betaling via de Mollie-betaal-ID (tr_xxxxx). De ID staat op een custom veld van de Betaling, dus u kunt vanaf beide kanten pivoteren:

Vanuit ERPNext — open de Betaling → zie Mollie-ID → zoek hem op in het Mollie-dashboard voor volledige betaalmethode-details.
Vanuit Mollie — kopieer de betaal-ID → zoek Betaling op via ID → zie de Verkoopfactuur die hij betaalde.

Wanneer de webhook niet aankomt

Het gangbaarste productieprobleem. Oorzaken:

Webhook-URL onbereikbaar. Mollie kan niet POSTen naar uw site — meestal een firewall / SSL-issue. Mollies dashboard toont webhook-afleverpogingen onder Developers → Logs.
Webhook-handtekening-mismatch. Bijna altijd betekent dat het Webhook Secret in Mollie Settings niet overeenkomt met wat Mollie heeft. Sla Mollie Settings opnieuw op om te regenereren, werk dan de URL in Mollies dashboard bij.
ERPNext-fout tijdens webhook-afhandeling. Check Integration Request List voor de webhook-ontvangst — er staat doorgaans een duidelijke traceback.

Herstel: Mollie herhaalt mislukte webhooks tot 24 uur lang. Wordt het probleem binnen dat venster opgelost, dan reconcilieert de betaling zichzelf. Na 24 uur moet u de Betaling handmatig aanmaken met verwijzing naar de Mollie-betaal-ID.