Overzicht

Mollie API: simpel & krachtig

Met de Mollie API integreer je betaalfunctionaliteit via Mollie direct in je eigen website of app. Mollie en je website praten met elkaar door HTTP requests naar elkaar te sturen.

Deze pagina geeft een overzicht van de Mollie API. De overige hoofdstukken onder het kopje Mollie API gaat in op een aantal specifieke aspecten van de API. Het is verstandig om deze hoofdstukken helemaal te lezen.

Het gedeelte van de documentatie onder de API-koppen beschrijft de gehele Mollie API op het allerdiepste niveau. Op dit niveau wordt beschreven hoe informatie wordt uitgewisseld in JSON HTTP requests, die heen en weer worden gestuurd tussen je website en Mollie.

Het is slim om de communicatie op dit diepste niveau aan de kant-en-klare Clients over te laten. Zo houd je controle, maar hoef je het wiel niet opnieuw uit te vinden.

Clients, modules en plugins

Een goed begin is het halve werk. Bespaar tijd en bouw op een veilige basis. Wij hebben o.a. Mollie API clients beschikbaar in PHP, Ruby, Node.js en Python. Natuurlijk bieden wij ook modules en plugins voor alle populaire webwinkelsystemen. Hier staat de hele lijst.

Betaalmethodes

Mollie voegt continu betaalmethodes toe. De Mollie API ondersteunt op dit moment de volgende betaalmethodes:

Al je geactiveerde betaalmethodes worden – voor zover ze van toepassing zijn – getoond aan de betaler. Betaalmethodes activeren kan in je Beheer.

Hoe werkt de Mollie API?

Afrekendiagram Mollie API

  1. Een bezoeker op je website wil een order gaan afrekenen.
  2. Je website zet een betaling klaar bij Mollie. Dit wordt gedaan door de API aan te roepen met het af te rekenen bedrag, de omschrijving van de transactie en de URL waar we de consument naar toe moeten sturen na de betaling.
    De API antwoordt op de aanroep met het unieke id van de nieuw aangemaakte betaling en de paymentUrl. Het id kan je website opslaan bij de order en je site stuurt de consument door naar de paymentUrl. Deze URL is het adres van het Mollie betaalscherm voor deze specifieke betaling.
  3. De consument komt op het Mollie betaalscherm, kiest een betaalmethode en rekent af. Deze hele stap neemt Mollie voor haar rekening. Hier hoef je niets voor te doen.
  4. Na betaling roept Mollie je Webhook aan en informeert hiermee je website over de nieuwe status van de betaling. Deze webhook kun je instellen via het Beheer óf bij het aanmaken van elke betaling meegeven.
    Als antwoord op de webhook hoeft je website alleen een HTTP-status 200 OK te geven. Mollie weet dan dat het verwerken van nieuwe status is gelukt – bij een andere status blijven we het proberen.
  5. Tijdens het verwerken van de webhook, haalt je website de status van de betaling op via de Mollie API. Op basis van deze bij Mollie opgehaalde status kan je website de order op betaald zetten en de verwerking ervan in gang zetten. Op dit punt wordt bijvoorbeeld ook een e-mailbevestiging naar de klant verstuurd.
  6. Nu stuurt Mollie de bezoeker terug naar je website. Je website weet dat de betaling is gelukt en deelt dit goede nieuws met de bezoeker.

Koppeling orders en betalingen

In het voorbeeld hierboven gaan we ervan uit dat je het id van de betaling in je order-tabel opslaat. Zo vindt je website bij het verwerken van de Webhook in één keer de juiste order bij de betreffende betaling. Je website onthoudt dus het unieke kenmerk van de betaling zelf. Zo komt de koppeling tussen betaling en order effectief tot stand. Deze aanpak is het makkelijkst te begrijpen en daarom gebruiken we hem in het voorbeeld.

Je kunt er echter ook voor kiezen om juist Mollie het unieke kenmerk van jouw order te laten onthouden door metadata aan de betaling mee te geven bij het aanmaken ervan. In ons voorbeeld zou je order_id hiervoor een logische kandidaat zijn. Mollie bewaart de metadata voor je. Als je in reactie op de Webhook de betaling ophaalt zit daar de metadata weer bij. Zo weet je óók precies welke order bij een betaling hoort. We adviseren je de aanpak waarbij je gebruik maakt van metadata toe te passen. Deze wordt het meest gebruikt en is vaak het makkelijkst te implementeren.

Voordelen van betalingen via de Mollie API

  • De betaalschermen zijn geschikt voor desktop-computers, smartphones en tablets.
  • Alle betaalmethodes die voor je account actief zijn en op de betaling van toepassing zijn, worden aan de consument getoond. Wanneer een nieuwe betaalmethode voor je account geactiveerd wordt, is deze onmiddellijk voor al je consumenten beschikbaar.
  • Als het een consument niet lukt om te betalen via de eerstgekozen betaalmethode kan heel makkelijk bij nader inzien een andere betaalmethode gekozen worden. Stel dat je consument bij het starten van een iDEAL-betaling ziet dat er tóch te weinig saldo is, dan kan alsnog afgerekend worden met een creditcard. Je website hoeft zich hier niet druk over te maken en jij hoeft hiervoor ook geen extra API's te implementeren.
  • Mollie zet de betaalmethodes in een voor de consument meest relevante volgorde. We zetten bijvoorbeeld bij Nederlandse consumenten iDEAL bovenaan en bij Belgische consumenten de (Belgische) betaalmethode Bancontact. Hier besteden we veel aandacht aan en we optimaliseren dit onder andere middels A/B-testing. Dit verhoogt je conversie zonder dat je er iets voor hoeft te doen.