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.

1. Open de Verkoopfactuur → klik Create Payment Request.

2. ERPNext maakt een Payment Request gekoppeld aan de Verkoopfactuur.

3. 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

4. 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.

5. 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.

6. 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.

1. Op de Verkoopfactuur, zoek de QR-code-sectie in het printformaat
   (de Mollie-integratie voegt een printformaat-snippet toe die u kunt
   opnemen).
2. Print en verstuur de papieren factuur; de QR-code staat erop.
3. 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:

1. Klant vult winkelmandje en klikt op Checkout.
2. ERPNext maakt de Verkooporder + Payment Request.
3. De integratie roept direct Mollies API aan om een betaling te
   maken.
4. Mollie retourneert een checkout-URL zoals
   https://checkout.mollie.com/pay/xxx.
5. Klant wordt direct doorgestuurd.
6. 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:

1. Klant rondt Mollie-checkout af.
2. Mollie POSTet naar uw webhook-endpoint met de betaalstatus.
3. De integratie valideert de webhook-handtekening.
4. Bij paid-status maakt de integratie een ERPNext-Betaling aan
   die naar de Verkoopfactuur verwijst (of de
   Verkooporder → Verkoopfactuur → Betaling-keten).
5. 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.