Betalen Beschikbaar
Mollie
Mollie is de eerste betaalprovider die schakl. spreekt. Je koppelt je eigen account, geeft één adres vrij op je edge, en de rest gebeurt op de factuur zelf.
Wat je nodig hebt
- Een Mollie-account waarin de betaalmethoden aanstaan die je wilt aanbieden. Welke dat zijn, blijft een keuze in het Mollie-dashboard.
- Een API-sleutel uit dat dashboard, onder Developers → API keys. Een testsleutel begint met test_, een live sleutel met live_.
- De modules Facturatie en Mollie aan onder Instellingen → Modules, en dekking op je licentie via Instellingen → Licentie: het zijn allebei gelicentieerde modules. Een verse installatie heeft eerst veertien dagen speling.
- Een host die vanaf internet bereikbaar is. Mollie weigert localhost, dus een lokale ontwikkelbak kan geen meldingen ontvangen.
- Beheerrechten om mollie.settings.manage en invoicing.payment.link toe te kennen.
Zo koppel je het
- 1 Haal je API-sleutel op in het Mollie-dashboard: Developers → API keys. Een testsleutel begint met
test_, een live sleutel metlive_; het zijn volledig gescheiden datasets. - 2 Ken in Instellingen → Rollen het recht
mollie.settings.managetoe. Standaard heeft alleen admin het, en de rolclientnooit. - 3 Ga naar Instellingen → Mollie en druk op Account toevoegen. Vul een Naam in waaraan je dit account herkent en plak de API-sleutel. Bij opslaan wordt de sleutel meteen geverifieerd.
- 4 Lees het resultaat. Modus toont Live of Test, afgeleid uit de sleutel zelf. Betaalmethoden toont wat Mollie terugmeldt: staat iDEAL er niet bij, dan staat het bij Mollie uit en niet hier. Een geweigerde sleutel toont Probleem met de sleutel met de tekst van Mollie erbij.
- 5 Kopieer het Meldingsadres en geef dat pad vrij op je edge. Staat er een toegangsproxy voor (bijvoorbeeld Cloudflare Zero Trust), maak dan een bypass-regel voor precies dat ene pad. Anders komen betalingen wel binnen bij Mollie, maar worden ze hier niet geboekt.
- 6 Oefen met de testsleutel: open een verzonden, openstaande factuur, druk in de kaart Online betalingen op Betaallink, doorloop de betaalpagina en forceer een eindstatus op het testscherm van Mollie.
- 7 Zet daarna de live sleutel erin, of voeg hem toe als tweede account en zet het testaccount op Niet in gebruik. Let op: een sleutel vervangen maakt een nieuw Meldingsadres aan, dus werk je edge-regel bij.
De betaling landt zelf op de factuur
Mollie stuurt bij elke statuswijziging één veld terug: het id van de betaling. Dat is een aanwijzing, geen feit. schakl. haalt de betaling daarna zelf op met jouw sleutel, en pas dat antwoord bepaalt status, bedrag, methode en betaalmoment. Alleen 'paid' schrijft een betaalregel, en die regel is dezelfde als wanneer een boekhouder hem had ingevoerd; de factuurstatus, de herinneringen en de boekhoudexport lopen dus vanzelf mee.
- Gereserveerd (authorized) telt niet als betaald: geld dat vaststaat is nog geen geld dat binnen is
- De kaart op de factuur toont de stand: Wacht op betaling, In verwerking, Betaald, Mislukt, Verlopen
- Mollie kan een melding niet opnieuw sturen; daarvoor bestaan de knop Status ophalen en de controle die elk uur draait
Geen kaartgegevens, geen tweede plek om methodes te kiezen
De betaler wordt doorgestuurd naar de betaalpagina van Mollie en komt terug op zijn eigen factuurpagina in het klantportaal, wat de uitkomst ook is. Welke methodes daar staan blijft een instelling in het Mollie-dashboard; het scherm hier meldt alleen wat Mollie antwoordde. schakl. pint bewust geen methode vast, zodat de keuzelijst van Mollie blijft staan en een mislukte poging met een andere methode kan worden overgedaan.
Test en live naast elkaar
Een sleutel is hier een rij en geen enkelvoudige instelling, juist zodat een testsleutel en een live sleutel tegelijk kunnen bestaan. Een testbetaling doorloopt de hele lus en stopt dan: er wordt niets geboekt en de kaart zegt 'Testbetaling: niet geboekt op deze factuur.' Die modus staat op de poging zelf, dus een sleutel later omzetten maakt een oude testbetaling nooit alsnog echt. En er wordt nooit voor je gekozen: zonder actief account weigert de knop, met twee actieve accounts vraagt hij welke, en alleen een live sleutel wint het van een testsleutel.
Begin met de testsleutel
Een groen instellingenscherm zegt dat je sleutel geldig is en verder niets: of iDEAL aanstaat, of het meldingsadres bereikbaar is en of het bedrag klopt, blijkt pas uit een echte betaling. Loop daarom eerst één keer de hele route met de testsleutel: maak een betaallink op een openstaande factuur, betaal hem, en kijk of de betaalregel op de factuur verschijnt. Mollie levert daarvoor testkaarten en bedragen die met opzet een specifieke fout afdwingen, zodat je ook ziet wat er gebeurt als het misgaat. Let op twee dingen: in testmodus werkt alleen euro, en een testbetaling boekt bewust nooit iets op de factuur.
Rechten
Geef deze rechten aan de rol die deze koppeling beheert (Instellingen → Rollen). Standaard alleen voor beheerders, en nooit voor de rol client.
-
mollie.settings.manageMollie-accounts toevoegen, verifiëren, vervangen en verwijderen, en het instellingenscherm lezen. Standaard alleen admin, nooit de rol client. -
invoicing.payment.linkEen betaling starten vanaf een factuur. Gescopeerd: admin krijgt :any, de rol client krijgt :own, zodat een klant alleen zijn eigen factuur kan betalen. -
invoicing.payment.writeEen betaling met de hand boeken. Standaard alleen admin en bewust niet iets wat een klant heeft; online staat niet in de lijst met handmatige betaalwijzen. -
settings.providers.readOptioneel. Zonder dit recht is de keuzelijst Leverancier verborgen in plaats van leeg.
Wat het bewust niet doet
- Geen terugbetalingen en geen terugboekingen: geld terugsturen doe je in het Mollie-dashboard.
- Geen incassomachtigingen, herhaalbetalingen of abonnementen aan de kant van Mollie.
- Geen Payment Links en geen Profiles API; twee sleutels herken je aan je eigen Naam en de waargenomen betaalmethoden.
- Nog geen ondertekende meldingen (X-Mollie-Signature): dat vraagt een tweede gegeven uit het Mollie-dashboard en is een apart traject.
- Een account verwijderen verandert niets bij Mollie, en de betaalpogingen blijven op hun factuur staan.
- Geen aparte betalingenmodule en geen lijst van betalingen los van de factuur die ze vereffenen.
Waar je het vindt Instellingen → Mollie, plus de kaart Online betalingen op een factuur.
Lees de handleiding