Mollie API koppelen aan je website.

Mollie is een betaalprovider uit Amsterdam, in het Engels een payment provider. Met één account bied je iDEAL, creditcards, Bancontact, Apple Pay, PayPal, SEPA-incasso en achteraf betalen aan. Je sluit geen contract per methode af. Je zet ze aan in het dashboard, per websiteprofiel.

Voor online betalingen rekent Mollie per transactie, zonder vast maandbedrag, en alleen voor betalingen die slagen. De vragen voor je website gaan daarna over het proces: waar wordt betaald, wat gebeurt er als iemand afhaakt, en hoe komt de betaling in je administratie. Werk je internationaal of met abonnementen in je eigen software, kijk dan ook naar Stripe koppelen; daar zetten we de twee naast elkaar.

De Mollie API is een REST API, versie 2, op api.mollie.com/v2. Elke aanroep heeft een API-sleutel bij zich, als Bearer-token in de Authorization-header. Per websiteprofiel krijg je er twee: een testsleutel die met test_ begint en een livesleutel die met live_ begint. Je vindt ze in het dashboard onder Developers en dan API keys, en een nieuwe sleutel zie je maar één keer.

Een betaling aanmaken is één aanroep naar de Payments API. Je stuurt het bedrag mee als valuta en waarde ("10.00" als tekst), een omschrijving van maximaal 255 tekens die de klant op zijn afschrift kan zien, het adres waar de klant na het betalen heen gaat en het adres van je webhook. In de metadata, tot ongeveer 1 kB, zet je je eigen ordernummer. Terug krijg je een betaling met een id dat met tr_ begint en een link naar de betaalpagina, waar je de klant naartoe stuurt.

Mollie begrenst het aantal aanvragen per organisatie, apart voor lezen en schrijven en voor test en live, zonder vast getal. Ga je eroverheen, dan volgt een 429 met een Retry-After-header die zegt hoeveel seconden je moet wachten. Voor een checkout is dat ruim; bij het ophalen van duizenden oude betalingen laat onze koppeling netjes wachten.

Denk aan een aanmelding voor een cursus, een reservering met aanbetaling, een offerte die direct betaald kan worden of een webshop in Next.js zonder WooCommerce. Er is geen winkelwagen, wel een formulier dat moet kunnen afrekenen.

Het formulier stuurt naar je eigen server, die de aanmelding opslaat en bij Mollie een betaling aanmaakt. De bezoeker gaat naar de betaalpagina van Mollie, rekent af met iDEAL of een andere methode en komt terug op je bedankpagina. Ondertussen meldt de Mollie webhook de nieuwe status en zet je server de aanmelding op betaald. De sleutel blijft op de server en komt nooit in de browser.

Wil je creditcardgegevens in je eigen pagina laten invullen, dan zijn er Mollie Components. Dat zijn kaartvelden die je in je eigen opmaak zet; de gegevens gaan rechtstreeks naar Mollie en jouw code ziet ze niet. Je krijgt een token terug dat een uur geldig is, en voor 3-D Secure gaat de klant alsnog even naar de bank. Voor facturen en offertes buiten de site om is er de Payment Links API, met dezelfde webhook.

Voor een gewone webshop is een plugin de juiste route. Mollie Payments for WooCommerce is van Mollie zelf, heeft meer dan 100.000 actieve installaties en werkt samen met WooCommerce Subscriptions voor terugkerende betalingen. Ook de blokcheckout van WooCommerce wordt ondersteund. Voor Mollie en Shopify biedt Mollie een eigen integratie aan. Wat een plugin al goed doet, bouwen wij niet opnieuw.

Maatwerk is aan de orde als er geen webshop is, als de betaling aan een ander systeem hangt, zoals een reserveringssysteem of CRM, of als de site op Next.js of Payload draait. Dan is een eigen Mollie integratie op de server de nette oplossing. Ook naast een plugin bouwen we soms iets, als de betaalstatus door moet naar een systeem dat de plugin niet kent.

Wie zoekt op een Mollie koppeling, bedoelt vaak de boekhouding. De meeste pakketten hebben daar een eigen koppeling voor. Aan de kant van de website zorgen wij dat de betaling herkenbaar binnenkomt.

In Moneybird zet je de koppeling met Mollie aan onder de administratie-instellingen. Moneybird koppelt de uitbetalingen van Mollie dan aan de juiste facturen. Betaalt de klant op je website en komt de factuur via de API in Moneybird, dan werkt dat volgens Moneybird alleen als de betaling met het transactie-id van Mollie op die factuur wordt geregistreerd. Dat nemen we mee als we Moneybird koppelen aan je site.

Voor SnelStart bouwt partner S for Software de Mollie-koppeling. Die zoekt openstaande debiteuren met een betaalkenmerk op in Mollie, zet ze op betaald via een tussenrekening en boekt de kosten van Mollie apart. Het betaalkenmerk moet dan wel in de betaling staan.

Werk je met Exact Online, dan laten wij bestellingen en facturen vanuit je site in Exact landen. De regel is overal dezelfde: één referentie, het ordernummer, in de omschrijving en de metadata van de betaling en op de factuur. Dan kan elk pakket de twee aan elkaar knopen.

Een betaling via Mollie gaat via een ander domein. Zonder instelling ziet Google Analytics de klant die terugkomt als een nieuwe sessie met Mollie als verwijzer, en krijgt je campagne de verkoop niet toegeschreven. Mollie hoort daarom in de lijst met uitgesloten verwijzingen.

Het tweede punt is wanneer je meet. Wie de conversie op de bedankpagina laat afgaan, telt ook geannuleerde betalingen mee en telt dubbel als iemand de pagina ververst. Wij laten de conversie afgaan op de status betaald, met het ordernummer erbij zodat hij maar één keer telt, en waar het kan vanaf de server. Hoe we dat inrichten, staat bij Data & Tracking.

Op WordPress met WooCommerce gebruiken we de plugin van Mollie en richten we de methodes, de referentie voor je boekhouding en de meting eromheen in. Zonder WooCommerce komt er een kleine uitbreiding op de server die vanuit je formulier de betaling aanmaakt en een eigen adres voor de webhook heeft.

Op een maatwerksite in Next.js zijn het twee serverroutes: een die de betaling aanmaakt en een die de webhook ontvangt, de status ophaalt en de aanmelding of bestelling bijwerkt. De sleutels staan als omgevingsvariabele op de server, met een aparte testsleutel voor de testomgeving.

Formulieren, checkouts en koppelingen als deze vallen bij ons onder Design & Development.