Overzicht
Mollie is de toonaangevende betaalserviceprovider voor Nederlandse en Belgische bedrijven, en één van de meest ontwikkelaarsvriendelijke betalings-API's in de Europese markt. Voor webapplicaties, e-commerceplatforms, SaaS-producten en elke digitale dienst die betalingen moet accepteren van Nederlandse en Europese klanten biedt Mollie de betalingsmethodendekking die de Europese markt vereist — iDEAL, Bancontact, SEPA Incasso, creditcards, PayPal, Klarna, Apple Pay, Google Pay en andere methoden die Europese klanten verwachten — via een enkele, goed gedocumenteerde API.
De positie van Mollie in de Nederlandse markt is bijzonder sterk. iDEAL — de Nederlandse online bankbetalingsmethode — is verantwoordelijk voor het merendeel van de Nederlandse online betalingen, en Mollie is één van de meest gebruikt iDEAL-verwerkers. Voor elk Nederlands bedrijf met een online betalingsvereiste is Mollie typisch de eerste integratie om te overwegen.
Wij bouwen Mollie-integraties voor Nederlandse en Europese bedrijven over alle applicatietypen — e-commerceplatforms, SaaS-abonnementsystemen, marktplaats betalingsstromen, B2B-factureringssystemen en elke applicatie die betrouwbare, conforme betalingsverwerking nodig heeft voor Europese klanten.
Wat Mollie Betalingsintegratie Dekt
Authenticatie en API-toegang. Mollie's API gebruikt eenvoudige API-sleutelauthenticatie zonder OAuth-complexiteit.
API-sleutels: Mollie biedt twee API-sleutels per organisatie — een test-API-sleutel voor ontwikkeling en testen, en een live-API-sleutel voor productie. De API-sleutel wordt doorgegeven in de Authorization: Bearer {api_key} header. Test-API-sleutels (voorafgegaan door test_) interageren met Mollie's testomgeving. Live-API-sleutels (voorafgegaan door live_) verwerken echte betalingen.
Organisatie versus profielsleutels: Mollie's API-sleutel kan worden gescopet naar het organisatieniveau of naar een specifiek betaalprofiel.
Mollie Connect OAuth: voor platforms die betalingen verwerken namens andere Mollie-verkopers. De OAuth-stroom die het platform autoriseert om betalingen aan te maken namens een verbonden verkoopaccount.
Betalingen aanmaken. De kern Mollie API-operatie — het aanmaken van een betaling die de klant voltooit via Mollie's gehoste betaalpagina.
Betaling aanmaken: het POST https://api.mollie.com/v2/payments eindpunt voor het aanmaken van een betaling. Het betalingsobject met amount (de currency en value — de waarde als string met precies twee decimalen), description, redirectUrl, webhookUrl en method (de betaalmethode, optioneel).
Betaalmethoden: de method parameterwaarden — ideal voor iDEAL, creditcard voor creditcard, bancontact voor Bancontact, paypal voor PayPal, applepay voor Apple Pay, klarnapaylater voor Klarna Achteraf Betalen, directdebit voor SEPA Incasso.
iDEAL bank selectie: de optionele issuer parameter die de bank van de klant vooraf selecteert. Het GET https://api.mollie.com/v2/methods/ideal eindpunt voor het ophalen van de lijst van beschikbare iDEAL-banken met hun namen en logo's.
Betaling redirect: de _links.checkout.href URL in de betalingsaanmaak respons — de Mollie-gehoste afrekenpagina-URL waarnaar de applicatie de klant naar doorstuurt.
Betaling metadata: het metadata object in het betalingsaanmaakverzoek voor het opslaan van willekeurige applicatiedata bij de betaling.
Betalingsstatus en verificatie. Betalingsstatus ophalen en betalingsvoltooiing verifiëren.
Betaling ophalen: het GET https://api.mollie.com/v2/payments/{paymentId} eindpunt voor het ophalen van de huidige status van een betaling. De betalingsstatus waarden — open, pending, authorized, paid, failed, canceled, expired.
Altijd server-zijde verifiëren: de redirect terug naar de redirectUrl na betaling bevestigt geen betalingssucces. Betalingsstatus moet altijd worden geverifieerd door de Mollie API te bevragen met de paymentId.
Webhooks — realtime statusnotificaties. Mollie's webhookmechanisme voor het ontvangen van betalingsstatuswijzigingen zonder pollen.
Webhook configuratie: de webhookUrl gespecificeerd in het betalingsaanmaakverzoek. Mollie stuurt een POST-verzoek met de id parameter die de betalings-ID bevat. De webhookafhandeler die deze notificatie ontvangt, de Mollie API bevraagt voor de huidige betalingsstatus en het resultaat verwerkt.
Webhook payload: de Mollie webhook POST bevat alleen de betalings-ID — niet de volledige betalingsstatus. De webhookafhandeler moet een afzonderlijke API-aanroep doen om de huidige betalingsstatus op te halen.
Webhook verificatie: Mollie bevat geen cryptografische handtekening in webhookverzoeken. De verificatie dat de webhook legitiem is komt van het bevragen van de Mollie API met de ontvangen betalings-ID.
Webhook herproberen: Mollie probeert mislukte webhooks opnieuw (niet-2xx respons) tot 15 keer over ongeveer 24 uur.
Idempotente webhookverwerking: webhooks kunnen meer dan eens worden geleverd. De idempotente webhookafhandeler die controleert of de betaling al is verwerkt voor actie te ondernemen.
Terugbetalingen. Terugbetalingen verwerken voor voltooide betalingen.
Terugbetaling aanmaken: het POST https://api.mollie.com/v2/payments/{paymentId}/refunds eindpunt voor het aanmaken van een terugbetaling. Het terugbetalingsobject met amount en description. Meerdere gedeeltelijke terugbetalingen zijn mogelijk voor een enkele betaling.
Terugbetalingsstatus: de terugbetalingsstatus waarden — queued, pending, processing, refunded, failed.
Orders API. Mollie's Orders API voor e-commerce integraties die orderbeheer naast betalingsverwerking nodig hebben.
Order aanmaken: het POST https://api.mollie.com/v2/orders eindpunt voor het aanmaken van een order met regelitems.
Order verzending: het POST https://api.mollie.com/v2/orders/{orderId}/shipments eindpunt voor het aanmaken van een zending die de opname van een Klarna-betaling triggert.
Abonnementen en terugkerende betalingen. Mollie's abonnementsfunctionaliteit voor SaaS en terugkerende facturering.
Mandaat aanmaken: de eerste betaling die een SEPA Incasso of creditcardmandaat vaststelt — de sequenceType: "first" parameter op de initiële betaling.
Terugkerende betalingen: het POST https://api.mollie.com/v2/payments eindpunt met sequenceType: "recurring" en de customerId — de server-geïnitieerde betaling die de klant debiteert zonder zijn interactie te vereisen.
Klantbeheer: het POST https://api.mollie.com/v2/customers eindpunt voor het aanmaken van Mollie-klantrecords die mandaten en betalingsgeschiedenis aggregeren.
Abonnementsbeheer: het POST https://api.mollie.com/v2/customers/{customerId}/subscriptions eindpunt voor door Mollie beheerde abonnementen.
Betaallinks. Deelbare betalings-URL's voor factuurBetaling en ad-hoc betalingsverzoeken.
Betaallink aanmaken: het POST https://api.mollie.com/v2/payment-links eindpunt voor het aanmaken van herbruikbare betaallinks.
Mollie Dashboard en rapportage. Programmatische toegang tot betalingsdata voor reconciliatie en rapportage.
Betalingen weergeven: het GET https://api.mollie.com/v2/payments eindpunt voor het weergeven van betalingen met filtering op status en datumbereik. Cursorgebaseerde paginering.
Afwikkelingsdata: het GET https://api.mollie.com/v2/settlements eindpunt voor het ophalen van Mollie-afwikkelingsdata.
Testen. Mollie's uitgebreide testomgeving voor integratieontwikkeling en -validatie.
Testomgeving: de test-API-sleutel die toegang geeft tot Mollie's testomgeving — een complete spiegel van de live API met gesimuleerde betalingsstromen voor elke betaalmethode.
Test betaalresultaten: de testmodus die succesvolle betalingen, mislukte betalingen en annuleringen simuleert voor elke betaalmethode.
Integratiepatronen
E-commerce afrekening. De standaard e-commerce betalingsstroom — klant voegt artikelen toe aan winkelwagen, gaat naar de kassa, de applicatie maakt een Mollie-betaling aan, de klant wordt doorgestuurd naar Mollie's afrekenspagina, de klant voltooit betaling, Mollie stuurt terug naar de applicatie, de applicatie verifieert betaling via de Mollie API, de applicatie vervult de order.
Factuurbetalingen. De B2B-factuurbetalingsstroom — de applicatie genereert een factuur, maakt een Mollie-betaallink aan, stuurt de betalings-URL per e-mail naar de klant.
SaaS-abonnementsfacturering. De terugkerende factureringsstroom — klant abonneert en voltooit de eerste betaling met sequenceType: "first", het mandaat wordt vastgesteld, volgende factureringscycli triggeren automatische betalingen.
Gebruikte Technologieën
- C# / ASP.NET Core — primaire Mollie integratie implementatie de
Mollie.Api.NET clientbibliotheek gebruikend - PHP / Laravel — Mollie-integratie voor PHP-gebaseerde e-commerce en webapplicaties de
mollie/mollie-api-phpbibliotheek gebruikend - TypeScript / Node.js — Mollie-integratie voor Node.js-applicaties het
@mollie/api-clientnpm-pakket gebruikend - Python — Mollie-integratie voor Python-gebaseerde applicaties de
mollie-api-pythonbibliotheek gebruikend - Rust / Axum — hoge-prestatie Mollie webhookverwerking en betalingsstatusbeheer
- REST / HTTP — Mollie API-communicatie
- Webhooks — realtime betalingsstatus levering
- SQL (PostgreSQL / MySQL) — betalingsrecords, orderstatus, mandaatopslag, reconciliatiedata
- Redis — idempotentiesleutel opslag, webhookdeduplicatie, betalingsstatuscaching
- Hangfire / geplande taken — abonnementsbetalingplanning, afwikkelingsreconciliatie
- Docker — gecontaineriseerde applicatie implementatie
- GitHub Actions — CI/CD pijplijn voor applicatie implementatie
Mollie in de Nederlandse E-commerce Context
Voor Nederlandse bedrijven maakt Mollie's combinatie van iDEAL-ondersteuning, SEPA Incasso voor abonnementen en het volledige bereik van internationale betaalmethoden het de meest praktische enkele betaalprovider voor de Nederlandse markt. De sterke voorkeur van de Nederlandse consument voor iDEAL — en de verwachting dat elke Nederlandse webwinkel het zal ondersteunen — maakt Mollie-integratie een bijna-vereiste voor elke Nederlandse consumentgerichte e-commerce of digitale dienst.
Betrouwbare Betalingsverwerking voor Nederlandse en Europese Bedrijven
Mollie-integraties gebouwd op productiestandaarden — correcte server-zijde betalingsverificatie die niet afhankelijk is van redirect-parameters, idempotente webhookafhandeling die dubbele orderverwerking voorkomt, uitgebreide testdekking met Mollie's testomgeving en de monitoring die betalingsfouten en webhooklevering problemen oppervlakt voor ze omzetimpact veroorzaken.