Stripe koppelen aan je website.

Stripe is een betaalprovider, in het Engels een payment provider, met een API waar veel software op draait. Je neemt kaarten, iDEAL, Apple Pay, SEPA-incasso en tientallen andere methodes af via één account, en je kunt in ruim 135 valuta's laten betalen.

Wat Stripe onderscheidt, is wat er naast betalen zit: abonnementen, facturen, btw-berekening en betaalpagina's die Stripe zelf onderhoudt. Op het standaardtarief betaal je per transactie, zonder opstart- of maandkosten.

De Stripe API is een REST API op api.stripe.com. Er zijn twee soorten sleutels. De publiceerbare sleutel, die met pk_ begint, mag in de browser staan en wordt gebruikt door Stripe.js. De sleutel voor de server is een beperkte sleutel (rk_) met alleen de rechten die de koppeling nodig heeft, of een geheime sleutel (sk_) met alle rechten. Stripe raadt de beperkte sleutel aan. Een zelf aangemaakte sleutel zie je in livemodus maar één keer.

Bouwen en testen doe je in een sandbox, met eigen sleutels die test in de naam hebben. Objecten uit de sandbox bestaan niet in livemodus, dus een product of prijs maak je in beide aan. De grens ligt live op 100 aanvragen per seconde per account en in de sandbox op 25. Een belastingtest in de sandbox loopt daardoor eerder vast dan de echte site ooit zal doen.

Elke aanroep die iets aanmaakt, krijgt bij ons een idempotentiesleutel mee. Valt de verbinding weg en sturen we dezelfde aanroep opnieuw, dan geeft Stripe het eerste antwoord terug en ontstaat er geen tweede betaling.

Stripe biedt drie routes, en de keuze bepaalt hoeveel je zelf bouwt en bijhoudt.

Payment Links zijn betaallinks die je in het dashboard maakt, zonder code. Handig voor een factuur, een workshop of een donatie, en te koppelen aan een knop op je site. Na betaling kan de klant terug naar een pagina op je website.

Stripe Checkout is een betaalpagina van Stripe die je volledig laat openen of in je eigen pagina insluit. Stripe onderhoudt de pagina, kiest welke methodes een klant ziet en regelt kortingscodes, verzendkosten en btw. Een sessie verloopt na 24 uur. Voor de meeste sites is dit de route, en Stripe raadt de onderliggende Checkout Sessions API zelf aan.

De Payment Element is een betaalblok dat je in je eigen checkout zet, onderdeel van Stripe Elements. Dat geeft het meeste eigen ontwerp. Combineer je het met Payment Intents, dan bouw je kortingen, btw en abonnementen zelf, en dat is alleen zinvol als je de hele checkout echt in eigen hand wilt hebben.

iDEAL, nu iDEAL | Wero, werkt bij Stripe voor klanten in Nederland, in euro. Je zet het aan in het dashboard, en Checkout, Payment Links en de Payment Element tonen het daarna vanzelf aan Nederlandse klanten. Een Nederlands Stripe-account kan iDEAL gewoon ontvangen.

Voor abonnementen gebruik je iDEAL voor de eerste betaling, waarna Stripe de volgende termijnen via SEPA-incasso afschrijft. Terugbetalen kan tot 180 dagen na de betaling. Een klant kan een iDEAL-betaling niet via zijn bank terugdraaien, dus vragen komen bij jou terecht.

Zet je KVK-nummer op je website; dat is een eis van iDEAL voor Nederlandse bedrijven. En houd rekening met de overstap naar Wero, die Stripe voor 2026 en 2027 aankondigt.

De vraag Stripe of Mollie komt bijna altijd. Beide rekenen per transactie zonder maandkosten, beide hebben iDEAL en een officiële plugin voor WooCommerce, en met beide bouwen we een eigen checkout. Hoe Mollie werkt, lees je bij Mollie koppelen.

De verschillen zitten in de details van de koppeling. Mollie stuurt in de webhook alleen een id en verwacht bedragen als tekst ("10.00"); Stripe stuurt een ondertekend event en verwacht centen. Stripe heeft meer ingebouwd rond abonnementen, btw en valuta's. Mollie is gebouwd vanuit de Europese betaalmethodes en zet die in één dashboard bij elkaar.

Ons advies hangt af van wat je verkoopt. Bij abonnementen in je eigen software of veel klanten buiten Europa ligt Stripe voor de hand. Bij een Nederlandse of Belgische webshop of een aanmeldformulier past Mollie net zo goed, en is het vaak al aanwezig. Wij bouwen met allebei.

Voor Moneybird bouwt Combidesk een koppeling die je Stripe-transacties elk uur ophaalt en betaalstatussen direct bijwerkt. Moneybird maakt die koppeling niet zelf. Voor Exact Online staan er apps van derden in de Exact App Store.

Aan de kant van de website zorgen wij dat elke betaling je eigen ordernummer meekrijgt, in de omschrijving en in de metadata, zodat het pakket de betaling aan de juiste factuur kan hangen. Komen de facturen zelf ook vanuit je site, dan regelen we dat als we Moneybird koppelen of een ander pakket.

Op WordPress met WooCommerce gebruiken we de plugin WooCommerce Stripe Payment Gateway. Die komt van WooCommerce, heeft meer dan 700.000 actieve installaties en ondersteunt iDEAL. Wij richten de methodes, de webhook en de meting in, zodat bestellingen alleen op betaald gaan als Stripe dat bevestigt.

Op een website in Next.js is het een serverroute die de Checkout Session aanmaakt, en een tweede route die de webhook ontvangt, de handtekening op de onbewerkte body controleert en de bestelling één keer afhandelt. Lokaal testen we met de Stripe CLI, die events doorstuurt naar de ontwikkelomgeving. De sleutels staan als omgevingsvariabele op de server.

Checkouts en koppelingen als deze vallen bij ons onder Design & Development.