Je koppelt je reserveringssysteem aan Mollie door bij het aanmaken van een betaling een webhookUrl en metadata met het boekings-ID mee te geven. Mollie meldt betaalstatussen vervolgens realtime via webhooks, zodat je boekingen automatisch bijwerken zonder handmatige controle. Voor Nederlandse leisurebedrijven is iDEAL daarbij de belangrijkste betaalmethode. Een platform zoals RaxBooker ondersteunt dit traject met kant-en-klare velden voor metadata en webhookconfiguratie.
Kort samengevat:
- Gebruik een publiek bereikbare webhook met HTTPS; tijdens lokale ontwikkeling maakt ngrok je server tijdelijk bereikbaar, omdat Mollie localhost niet kan aanroepen.
- De webhook bevat alleen een betalingsnummer, dus haal daarna zelf de actuele status op en koppel die via metadata aan het juiste boekingsnummer.
- Geef je eindpunt altijd een 200 OK en sla verwerkte betalingsnummers op, zodat herhaalde meldingen ook bij tijdelijke storingen geen dubbele boekingsbevestiging veroorzaken.
- Begin met iDEAL en test in de sandbox alle gebruikte betaalstatussen, waaronder mislukte betalingen en terugbetalingen, voordat je live sleutels inzet.
- Registreer btw zodra je een vooruitbetaling factureert of ontvangt, informeer gasten over betaalgegevens en leg Mollies rol vast in een verwerkersovereenkomst.
Inhoudsopgave
- Wat moet je vooraf regelen voor je Mollie koppelt aan je boekingssysteem?
- Stap voor stap: betaling aanmaken, webhook verwerken en boeking bijwerken
- Testchecklist en veelvoorkomende valkuilen bij de koppeling
- Welke Nederlandse wet- en regelgeving speelt bij betaalafhandeling?
- Hoe pas je dit toe binnen RaxBooker?
- Waar moet je als leisurebedrijf prioriteit aan geven?
- Hoe RaxBooker de Mollie-koppeling voor je vereenvoudigt
- Veelgestelde vragen
- Bronnen
Wat moet je vooraf regelen voor je Mollie koppelt aan je boekingssysteem?
Voordat je begint met de technische koppeling, zet je een paar zaken klaar. Zonder deze basis loop je vast bij de eerste testbetaling.
- Een Mollie-account met zowel test- als live-API-sleutels, zodat je zonder risico kunt ontwikkelen voordat je live gaat.
- Toegang tot je reserveringssysteem om metadata-velden en de webhookUrl te configureren per boeking.
- Een publiek bereikbare webhook-URL met HTTPS; voor lokale ontwikkeling gebruik je ngrok om je lokale server tijdelijk publiek bereikbaar te maken, omdat Mollie geen localhost-adressen kan aanroepen.
- Een keuze voor betaalmethoden, waarbij iDEAL als toonaangevende Nederlandse betaalmethode prioriteit krijgt bij activering.
- Een veilige opslag van je API-sleutels, nooit in broncode of openbare repositories.
Zodra deze punten staan, kun je de daadwerkelijke koppeling bouwen.
Stap voor stap: betaling aanmaken, webhook verwerken en boeking bijwerken
De koppeling bestaat uit drie onderdelen: een betaling aanmaken, een statusmelding ontvangen en je boekingssysteem bijwerken. Dat gebeurt in deze volgorde:
- Maak een betaling aan via de Payments API met daarin
webhookUrl,redirectUrl, een omschrijving enmetadatawaarin je het boekings-ID meegeeft. Deze velden zorgen dat je later weet welke boeking bij welke transactie hoort. - Bouw een webhook endpoint dat een POST-verzoek met een parameter
idontvangt. Dat verzoek bevat geen betaalstatus zelf: je roept vervolgensGET /payments/{id}aan om de actuele status op te halen, zoals de Mollie-documentatie beschrijft. - Verwerk de statussen die Mollie teruggeeft:
paid,pending,failed,expiredenauthorized. Map elke status naar je interne boekingsstatus, bijvoorbeeldpaidnaar "bevestigd" enexpirednaar "geannuleerd wegens niet-betaling". - Regel aanbetalingen en optie-reserveringen via metadata en, waar relevant, de
sequenceType- en bedraglogica van Mollie, zodat een eerste aanbetaling en een later resterend bedrag beide herleidbaar blijven naar dezelfde boeking. - Test eerst in de sandbox met je test-API-sleutel en simuleer alle statussen voordat je live-sleutels gebruikt.
- Zorg voor logging en idempotentie: sla verwerkte betalings-ID's op zodat een herhaald webhook-verzoek niet tot een dubbele statuswijziging leidt, en laat je endpoint altijd een 200 OK teruggeven.
Pro-tip: bouw je webhook-logica zo dat elke statuswijziging een los, herleidbaar logregel oplevert; dat scheelt uren zoeken wanneer een gast belt over een "verdwenen" betaling.
Voor aanbetalingen bij meerdaagse of groepsboekingen raden we aan metadata consequent te gebruiken voor zowel het boekings-ID als het type transactie (aanbetaling of resterend bedrag), zodat je financiële rapportage achteraf niet handmatig hoeft te worden uitgezocht. Onze eigen uitleg over aanbetalingen bij boekingen gaat hier verder op in.
Testchecklist en veelvoorkomende valkuilen bij de koppeling
Voor je live gaat, loop je een vaste testronde af. De meeste problemen ontstaan door een paar herkenbare oorzaken.
- Controleer of je webhook-URL publiek bereikbaar is; in ontwikkeling gebruik je ngrok, in productie een vast domein met HTTPS.
- Laat je endpoint altijd 200 OK teruggeven: bij een andere responscode of een time-out probeert Mollie het verzoek opnieuw.
- Verwar test- en live-API-sleutels niet; een betaling aangemaakt met een test-sleutel verschijnt nooit in je live-omgeving.
- Controleer dat metadata met het boekings-ID correct wordt meegegeven en teruggelezen, anders raakt een betaling los van de bijbehorende boeking.
- Test alle statussen die je gebruikt, dus niet alleen
paid, maar ookfailed,expireden een terugbetaling. - Log fouten expliciet en bouw retry-logica in voor het geval je eigen server tijdelijk niet bereikbaar is.
Mollie beschrijft dat een webhook een 200 OK verwacht en bij uitblijven daarvan het verzoek herhaalt, wat betekent dat een falende of langzame endpoint leidt tot herhaalde meldingen voor dezelfde betaling (Mollie-documentatie). Bouw je verwerking daarom idempotent, zodat een dubbele melding nooit tot een dubbele boekingsbevestiging leidt.
Welke Nederlandse wet- en regelgeving speelt bij betaalafhandeling?
Een betaalkoppeling raakt ook aan privacy- en belastingregels. Een paar punten die je vooraf moet regelen:
- Informeer gasten over welke betaalgegevens worden verwerkt en door wie; de Autoriteit Persoonsgegevens stelt dat betaaldienstverleners persoonsgegevens verwerken en dat je daarvoor aan de AVG moet voldoen.
- Bewaar alleen betaalgegevens die je daadwerkelijk nodig hebt en leg vast welke rol Mollie als verwerker heeft in een verwerkersovereenkomst.
- Richt je facturatie op vooruitbetalingen correct in: volgens de Belastingdienst ontstaat btw-plicht bij facturering of ontvangst van een vooruitbetaling, dus je boekingssysteem moet dat moment correct registreren.
- Houd rekening met de herroepingsknop die de ACM vanaf juni 2026 verplicht stelt voor online dienstverlening, wat gevolgen heeft voor je annulerings- en terugbetalingsproces.
Hoe pas je dit toe binnen RaxBooker?
Binnen RaxBooker regel je de koppeling via een paar concrete instellingen. Metadata-velden voor het boekings-ID staan standaard klaar, net als configuratie voor webhookadressen per activiteit of locatie.
- Stel per activiteit of arrangement in welk metadata-veld het boekings-ID bevat, zodat betalingen automatisch aan de juiste boeking koppelen.
- Gebruik onze uitleg over aanbetalingen bij boekingen als basis voor vooruitbetalingen en resterende bedragen.
- Lees de praktische gids over veiligheid en privacy in recreatiecentra voor de AVG-kant van betaalgegevens.
- Schakel bij migratie vanuit een ander systeem ondersteuning in voor de technische kant als dat nodig is.
- Test de koppeling eerst in een testomgeving met een paar proefboekingen voordat je live gaat met echte gasten.
Waar moet je als leisurebedrijf prioriteit aan geven?
Begin met één betaalmethode, namelijk iDEAL, en test die grondig voordat je andere methoden toevoegt. Automatiseer statusupdates via webhooks: dat voorkomt het handmatige afvinken van betalingen dat in de praktijk de meeste fouten oplevert. Heb je geen eigen ontwikkelaar, schakel dan tijdig ondersteuning in bij de migratie, zodat de livegang niet vastloopt op een technisch detail.
— Bernard
Hoe RaxBooker de Mollie-koppeling voor je vereenvoudigt
Wij hebben de velden voor metadata, webhookconfiguratie en aanbetalingen al ingericht in onze boekingssoftware voor de leisure, zodat je niet vanaf nul een koppeling hoeft te bouwen. Dat betekent minder uitzoekwerk voor je eigen team en een kortere weg naar een werkende betaalflow met iDEAL en de andere methoden die Mollie ondersteunt.
- Wij richten webhookUrl en metadata-mapping voor je in, afgestemd op jouw activiteiten en arrangementen.
- Er is begeleiding beschikbaar bij technische migratie wanneer je van een ander systeem komt.
- Je vindt de details over functies en koppelingen op onze pagina voor reserveringssoftware.
Wil je weten wat een koppeling met Mollie voor jouw boekingsproces oplevert? Vraag een demo aan via onze reserveringssoftware pagina en we bekijken samen welke stappen voor jouw situatie nodig zijn.
Veelgestelde vragen
Wat is een Mollie-webhook en waarom heb je die nodig?
Een webhook is een melding die Mollie naar je server stuurt zodra de status van een betaling verandert. Je gebruikt die melding om automatisch de betaalstatus van een boeking bij te werken, zonder dat iemand dat handmatig moet controleren in de Mollie-documentatie.
Welke betaalmethode kies je als eerste voor Nederlandse gasten?
Begin met iDEAL, de meest gebruikte betaalmethode in Nederland en direct beschikbaar via Mollie. Voeg andere methoden pas toe nadat deze stabiel werkt in je boekingsflow.
Hoe test je een Mollie-webhook lokaal tijdens ontwikkeling?
Gebruik ngrok om je lokale ontwikkelomgeving tijdelijk publiek bereikbaar te maken, want Mollie kan geen localhost-adressen aanroepen. Simuleer vervolgens de verschillende betaalstatussen in de testomgeving voordat je naar een live-sleutel overstapt.
Wat gebeurt er als een betaling mislukt of wordt terugbetaald?
Mollie meldt statussen zoals failed, expired en terugbetalingen via de webhook, waarna je die status koppelt aan de bijbehorende boeking in je systeem. Zorg dat je boekingssysteem deze statussen apart afhandelt, bijvoorbeeld door de boeking automatisch te annuleren of een nieuwe betaallink te sturen.
Moet je gastgegevens apart beveiligen bij betalingen via Mollie?
Ja, de Autoriteit Persoonsgegevens verwacht dat je gasten informeert over de verwerking van betaalgegevens en dat je alleen noodzakelijke gegevens bewaart. Leg daarnaast vast welke rol Mollie als verwerker speelt in een verwerkersovereenkomst.
Bronnen
- Webhooks | Introduction to the Mollie API | Mollie Documentation
- iDEAL | Mollie
- Voorschotnota's en vooruitbetalingen — Belastingdienst