Adyen developer · internationaal · omnichannel · marketplaces
Adyen developer
Maatwerk Adyen-integraties voor webshops die internationaal of omnichannel schalen: recurring met network-tokens, marketplaces via Balance Platform, RevenueProtect-regels op maat en notification-flows die nooit een order verliezen.
- Sinds 2008
- Payment-ervaring
- Adyen API
- Checkout v71 · webhooks
- Omnichannel
- Online · POS · in-app
- RevenueProtect
- 3DS2 · risk-rules
Waarom dit ertoe doet
Adyen is gebouwd voor schaal. De standaard plug-in benut die schaal niet.
Adyen is de PSP-keuze als je internationaal, omnichannel of multi-merchant verkoopt: ruime API, lokale acquiring, één account voor online en POS. Maar de standaard plug-in dekt de basis-consumenten-checkout. Recurring met network-tokens, RevenueProtect-regels op maat, marketplace-splits en reporting-koppelingen vragen om een developer die de Adyen API van binnen kent.
100+ methodes, één checkout
iDEAL, Bancontact, kaart, Klarna, Twint, BLIK, OXXO, PIX, GrabPay — geordend per land, valuta en device, met de juiste default vooraf-geselecteerd.
Recurring & tokenization
Stored payment methods met network-tokens, MIT/CIT-onderscheid, schemeTokens en correcte recurringProcessingModel — abonnementen, one-click of MOTO.
Omnichannel: online ↔ POS
Eén Adyen-account voor webshop, terminals en in-app. Klant koopt online, retourneert in de winkel — op één klantkaart, één rapportage.
RevenueProtect zonder verlies
Risk-rules op velocity, BIN, AVS en device-fingerprint. 3DS2 met soft-decline-retry en exemption-routing — fraude eruit, conversie erin.
Marketplaces & split payments
Adyen for Platforms: onboarding van merchants via KYC, split-payouts per transactie, application fees en transfer-instruments per partij.
Inzicht per methode en markt
Per Adyen-methode authorization-rate, weigerredenen en kostprijs — beslissingen op data uit de Adyen Reporting API, niet op gevoel.
Twijfel je waar de winst zit? Ik denk graag mee — gewoon Maarten zelf, geen sales-trechter.
Hoe het eruit ziet
Checkout en notifications — voor en na
Twee plekken waar het verschil meetbaar is: de Adyen-checkout die je klant ziet, en de notification-verwerking die je nooit ziet — totdat hij faalt.
Adyen checkout · stap 3
/paymentMethodsMethodes per land, valuta en device — gestuurd door Adyen's /paymentMethods.
iDEAL
Aanbevolen · NL
Creditcard
Visa · MC · Amex · network-token
Apple Pay
Express · device-detected
Klarna · Pay later
DE/NL · tussen € 50–1.000
Bancontact
BE
PayPal
Wallet
Adyen notification log
healthyHMAC-check + idempotency per pspReference, replay-veilig, gelogd in eigen dashboard.
- 14:02:11AUTHORISATION8836172612345678200
- 14:02:24CAPTURE8836172612345678200
- 14:08:09RECURRING_CONTRACTSH-4821200
- 14:12:51REFUSED · 20038836172698761234200
- 14:13:02REFUND8836172645671230200
HMAC
signature-verified
Idempotent
replay-veilig
Re-fire
uit dashboard
Wil je dit ook zien werken in jouw shop? Ik denk graag mee — gewoon Maarten zelf, geen sales-trechter.
Herkenbaar?
Veelvoorkomende Adyen-problemen — en wat ik eraan doe
Negen van de tien Adyen-trajecten beginnen met een van deze klachten. Goede kans dat jij er ook minstens één herkent.
Standaard plug-in dekt geen serieuze schaal
Pijn: De officiële Adyen-module werkt voor één markt, één valuta en een basis-checkout. Zodra je internationaal verkoopt, met recurring of split payments, loopt het vast.
Aanpak: Eigen integratie tegen Adyen Checkout API en Web Components, naast of bovenop de plug-in. Alleen de logica die jij nodig hebt — getypt en schoon.
Notificaties komen aan, status blijft hangen
Pijn: Adyen stuurt AUTHORISATION, CAPTURE en REFUND — maar de order in WooCommerce of Magento blijft op 'pending'. Voorraad blokkeert, klantenservice ploetert.
Aanpak: Notification-handler met HMAC-verificatie, idempotency per pspReference en automatische retry. Adyen event-codes netjes gesynct naar order-status, per event gelogd.
Authorization-rate loopt achter op de markt
Pijn: Conversie zakt op kaart-betalingen. Issuers weigeren transacties die wél hadden moeten lukken — vaak door verkeerd 3DS2-gebruik of ontbrekende network-tokens.
Aanpak: 3DS2 met exemption-routing (TRA, low-value), network-tokens via Adyen, soft-decline-retry en BIN-based routing. Auth-rate per methode meetbaar in een dashboard.
Recurring werkt — tot de kaart verloopt
Pijn: Klant betaalt al twee jaar, totdat de kaart verloopt of opnieuw uitgegeven wordt. Subscription valt om, niemand merkt het tot een klant belt.
Aanpak: Account Updater geactiveerd, monitoring op shopperReference, branded retry-mails en self-service kaart-update via een secure Web Components-link.
Refunds & captures zijn handwerk
Pijn: Bij elke retour: refund in Adyen Customer Area, status terug in de shop, credit-nota in Exact of NetSuite. Drie systemen, drie kansen op fouten.
Aanpak: Eén knop in je back-office. Modifications-API call (refund/cancel/capture), status-sync via webhook, credit-nota in de boekhouding — auditbaar per regel.
Internationaal: alles 'werkt', niets converteert
Pijn: Methodes staan aan voor alle markten, maar Duitsers willen geen iDEAL en Brazilianen willen PIX. Lokale checkouts ontbreken, conversie zakt per markt.
Aanpak: Methodes per land en valuta uit Adyen's /paymentMethods, lokale defaults, currency-conversion via DCC waar gewenst en local acquiring waar het kan.
Sparren over je Adyen-setup?
Checkout, recurring en risk op één lijn.
Ik kijk mee in je Adyen-config, benoem waar de winst zit en schets samen met je een aanpak per onderdeel.
Recurring & risk
De stille winstmakers van Adyen
Twee onderdelen die zelden zichtbaar zijn voor de klant, maar die maandelijks het verschil maken tussen 'het draait' en 'het verdient'.
Recurring lifecycle
network-tokensStored payment methods + Account Updater + smart retry.
- Maand 1
Initial payment (CIT)
shopperReference SH-4821 · token opgeslagen
- Maand 2
Recurring (MIT) geslaagd
scheme-token gebruikt · auth-rate 99,2%
- Maand 6
Account Updater hit
verlopen PAN vervangen door nieuwe
- Maand 9
Refused: 2003 (Refused)
soft-decline retry over 24u ingepland
- Maand 9
Retry geslaagd
geen klant-actie nodig
- Maand 12
Branded dunning-mail
self-service kaart-update via Web Components
RevenueProtect · risk-rules
tuned per marktScore-based routing tussen frictionless, 3DS2 challenge en exemption.
| Rule | Δ score | Actie |
|---|---|---|
| Velocity (IP) — 5 / 10 min | +25 | Challenge 3DS2 |
| BIN-country ≠ ship-country | +40 | Challenge 3DS2 |
| AVS mismatch (street) | +15 | Allow + log |
| Device-fingerprint match (trust) | −30 | Frictionless |
| Low-value (< € 30) | −20 | TRA-exemption |
Adyen for Platforms
Eén betaling, automatisch gesplitst over verkopers
Voor marketplaces en SaaS-platformen met onder-merchants is Adyen's Balance Platform de krachtigste optie van Europa: KYC-onboarding, transfer-instruments per verkoper en automatische split-payouts per transactie. Application fees, processing-kosten en payouts lopen door één auditbare laag.
- Hosted Onboarding of API-only KYC
- Split per transactie of per batch
- Application fees naar het liable account
- Payouts naar SEPA, lokale rails of card-on-file
Split payment · order #10421
Balance PlatformEén transactie, automatisch gesplitst over twee verkopers en marketplace.
- € 89,40
Merchant A — Atelier Noord
transfer-instrument NL44…
- € 124,10
Merchant B — Studio Zuid
transfer-instrument NL12…
- € 18,52
Marketplace fee (8%)
naar liable account
- € 3,48
Adyen processing fees
automatisch verrekend
Wat het oplevert
Voorbeelden van wat een goede Adyen-developer toevoegt
Een Adyen-integratie hoort iets op te leveren, niet alleen 'te werken'. Dit zijn voorbeelden van wat ik bij eerdere shops heb ingebouwd — als inspiratie voor wat in jouw situatie kan.
Methodes per land, valuta en device
iDEAL bovenaan in NL, Klarna in DE, PIX in BR. Logica op één plek, gestuurd door Adyen's /paymentMethods en device-detection in de Web Components-config.
Network tokens & Account Updater
Stored payment methods met scheme-tokens; Account Updater vervangt automatisch verlopen kaartnummers, branded retry-mails vangen de rest op.
POS-koppeling met shopperReference
Adyen-terminal in de winkel gekoppeld aan dezelfde shopper als online. Online aankoop in de winkel terugbrengen, één rapportage in Adyen.
Split payments via Adyen for Platforms
KYC-onboarding voor merchants, application fees per transactie, automatische payouts naar transfer-instruments per verkoper — auditbaar in Balance Platform.
Apple Pay & Google Pay als express-checkout
Express-knop op product-, cart- en mini-cart, adres + shipping in één tap. Apple/Google Pay via Adyen Web Components, fallback naar standaard flow.
RevenueProtect-regels op maat
Velocity-checks per BIN/IP, AVS- en CVC-mismatch-scores, device-fingerprint en custom risk-fields uit je shop — tuned per markt, niet één globale regel.
Welk voorbeeld past het beste op jouw shop? Ik denk graag mee — gewoon Maarten zelf, geen sales-trechter.
Wat ik bouw
Onderdelen die ik dagelijks oplever
Elk onderdeel hieronder is een afgebakende klus die ik vaak los of in combinatie oppak. Klein genoeg voor een sprint, groot genoeg om verschil te maken.
Drop-in & Web Components
Adyen Drop-in voor snelheid, of losse Web Components voor een single-page checkout met je eigen styling.
Recurring & tokenization
shopperReference, recurringProcessingModel, stored payment methods en MIT/CIT-flows volgens scheme-regels.
3-D Secure 2 / SCA
Native 3DS2-flow, exemption-routing (TRA, low-value, MIT), soft-decline-retry en challenge-monitoring.
Notification handler
HMAC-verificatie, idempotency op pspReference, retry-queue en re-fire vanuit een eigen dashboard.
Modifications-flow
Capture, refund, cancel en chargeback-disputes met evidence-uploads vanuit je back-office.
Reporting & boekhouding
Adyen Reporting API → settlement-detail-rapporten geparsed en geboekt in Exact, NetSuite, AFAS of Moneybird.
Local acquiring & DCC
Local acquiring per markt voor lagere fees en hogere auth-rate, DCC waar gewenst voor extra marge.
Adyen for Platforms
Marketplaces, SaaS-platformen en multi-merchant: KYC, transfer-instruments, payouts en application fees.
Omnichannel POS
Terminal-API koppeling, POS-payments aan dezelfde shopper als online, in-store returns voor online orders.
PCI via tokenization
Web Components + tokenization — kaartdata raakt jouw server nooit. SAQ-A in plaats van SAQ-D.
Branded retry & dunning
Templates per refusalReason, retry-schema op exponential backoff en self-service kaart-update.
Smart routing naast Adyen
Adyen als hoofd-PSP, fallback of cost-routing naar Stripe of Mollie voor specifieke methodes of markten.
Een specifieke feature in je hoofd? Ik denk graag mee — gewoon Maarten zelf, geen sales-trechter.
Platformen
Webshop-platformen waar ik Adyen mee koppel
WooCommerce
Custom gateway, blocks-checkout, B2B-extensies
Magento 2 / Adobe Commerce
Adyen-module verlengd, multi-store, multi-website
Shopware 6
Plug-in extension, Enterprise B2B
Headless / custom
Next.js, TanStack, Nuxt, eigen back-office
Salesforce Commerce Cloud
LINK cartridge, SFRA & SiteGenesis
Custom SaaS
Adyen Checkout API + Balance Platform
Ander platform? Vraag het even. Ik denk graag mee — gewoon Maarten zelf, geen sales-trechter.
Kansen per sector
Waar de winst zit, per type business
International retail & D2C
- Lokale methodes per markt
- Local acquiring voor hogere auth-rate
- Apple Pay / Google Pay express-checkout
- Conversie-tracking per methode en markt
SaaS, memberships & subscriptions
- Recurring met network-tokens
- Account Updater voor verlopen kaarten
- Dunning-flow met retry-schema's
- Self-service kaart-update via secure link
Marketplaces & platforms
- Adyen for Platforms (Balance Platform)
- KYC-onboarding voor merchants
- Split payouts en application fees
- Transfer-instruments per verkoper
Omnichannel retail
- POS-terminals aan webshop-account
- Online-aankoop, in-store retour
- Eén shopperReference over alle kanalen
- Geconsolideerde reporting
Hoe het werkt
Een Adyen-traject in 4 stappen
- 01
Intake & audit
Een gesprek over je huidige Adyen-setup, checkout en notification-flow. Ik kom met een lijst quick wins en grotere verbeterpunten — met scope-inschatting.
- 02
Concreet voorstel
Per onderdeel: wat ik bouw, in welke volgorde en met welke aannames. Afgebakend per sprint, zonder open einden.
- 03
Bouwen in test-mode
Volledige flow in Adyen Test Customer Area en staging-shop. Demo per sprint op een preview-URL, met notification-monitor en logging.
- 04
Go-live en monitoring
Gefaseerde uitrol over je verkeer, alerts op refusal-rates en 3DS2-challenges, optionele retainer voor doorontwikkeling.
Klaar om de eerste stap te zetten? Ik denk graag mee — gewoon Maarten zelf, geen sales-trechter.
Waarom Maarten
Eén ervaren payment-developer. Geen bureau, geen tussenlagen.
Ik koppel sinds 2008 betaalproviders aan webshops — van handgeschreven SOAP tegen iDEAL-basic tot moderne Adyen-integraties met Web Components, Balance Platform en Terminal-API. Die ervaring zit in elke beslissing: welke notification idempotent hoort te zijn, waar je een retry-schema laat lopen, en wanneer je een tweede PSP naast Adyen zet.
Geen accountmanager. Geen Jira-tickets die zwerven. Je werkt direct met de persoon die de code schrijft en de notifications debugt — met eerlijk advies, ook als dat betekent: "dit hoef je niet te bouwen".
Sinds 2008
Bekend met de scherpe randen van élke methode en PSP.
Korte lijnen
Direct contact met de developer, zonder accountmanager ertussen.
Geen lock-in
Standaard Adyen Checkout API, schone code, jij houdt alles in handen.
Eerlijk advies
Soms is uitbreiden niet de winst. Dat hoor je dan ook.
FAQ
Veelgestelde vragen over Adyen
Wanneer kies je voor Adyen in plaats van Mollie of Stripe?
Wanneer kies je voor Adyen in plaats van Mollie of Stripe?
Adyen wint zodra je internationaal verkoopt, omnichannel werkt (online + POS), of een marketplace draait. Mollie is sterker voor de Benelux-consumentenshop, Stripe is sterk voor SaaS in de VS. Voor merchants met serieuze schaal, lokale acquiring-wensen of een eigen platform met onder-merchants is Adyen vaak de juiste keuze.
Werk je met de standaard Adyen-plug-in of bouw je alles zelf?
Werk je met de standaard Adyen-plug-in of bouw je alles zelf?
Beide. Voor de meeste shops is de officiële Adyen-plug-in (Magento, Shopware, WooCommerce) een prima fundament dat ik uitbreid met de stukken die ontbreken — recurring-logica, marketplace-splits, custom risk-rules. Voor headless of custom stacks bouw ik direct tegen de Adyen Checkout API met Web Components.
Welke shop-platformen ondersteun je?
Welke shop-platformen ondersteun je?
WooCommerce, Magento 2 / Adobe Commerce, Shopware 6, Salesforce Commerce Cloud, plus headless stacks (Next.js, TanStack Start, Nuxt) en eigen back-office systemen. Een ander platform kan vaak ook.
Hoe zit het met Adyen for Platforms (marketplaces)?
Hoe zit het met Adyen for Platforms (marketplaces)?
Voor marketplaces en SaaS-platformen werk ik met Adyen's Balance Platform: KYC-onboarding via Hosted Onboarding of API, transfer-instruments per merchant, split-payouts per transactie en application fees. Inclusief webhook-handlers voor onboarding-status en payout-events.
Kunnen jullie ook andere PSP's koppelen?
Kunnen jullie ook andere PSP's koppelen?
Ja. Ik werk ook met Mollie, MultiSafepay, Stripe, Buckaroo en Pay. Voor maatwerk-checkouts combineer ik regelmatig Adyen met een tweede PSP, met smart routing op kostprijs, methode-dekking of uptime.
Hoe zit het met PCI-compliance?
Hoe zit het met PCI-compliance?
Door Adyen Web Components en tokenization raakt kaartdata jouw server nooit. Dat houdt je op SAQ-A in plaats van SAQ-D — een wereld van verschil qua audit-overhead.
Wat doe je met failed recurring payments?
Wat doe je met failed recurring payments?
Account Updater voor automatische kaart-vervanging, een slim retry-schema (op refusalReason en BIN), branded dunning-mails en een self-service kaart-update via een Web Components-pagina met tokenization.
Kan ik later met een ander team verder?
Kan ik later met een ander team verder?
Ja. Ik werk op de officiële Adyen Checkout API met schone code en documentatie. Geen vendor lock-in, je hebt geen Maarten nodig om ermee verder te kunnen.
Doe je ook de migratie van een andere PSP naar Adyen?
Doe je ook de migratie van een andere PSP naar Adyen?
Regelmatig. Inclusief data-migratie van actieve recurring contracts (via card-on-file portability waar mogelijk), parallelle test-periode en gefaseerde uitrol zonder downtime.
Hoe ga je om met failed notifications?
Hoe ga je om met failed notifications?
Notification-handler met idempotency op pspReference, een queue voor retry op exponential backoff, en een dashboard waar je manueel kunt re-fire. Plus alerts als de error-rate spiket of de Adyen-notification-queue oploopt.
Sparren over je Adyen-setup?
Checkout, recurring en risk op één lijn.
Ik kijk mee in je Adyen-config, benoem waar de winst zit en schets samen met je een aanpak per onderdeel.
