Medusa now ships with an official Adyen payment provider supported by the core team. It is available from Medusa v2.22.2, installed with the core, and maintained by the Medusa team. Alongside the release, Adyen is now an official Medusa partner.
The new provider ships with Medusa and follows our release process, so bug fixes and security patches reach you with every Medusa update. In addition, we make sure the provider always supports the newest and best of Adyen's features.
Considering setting up Adyen with Medusa? We'll help you move over. Get in touch.
Medusa Adyen Partnership
Adyen is a global payments platform used by brands such as L'Oréal, Foot Locker, Dunelm and Aritzia. It handles processing, local payment methods, risk management and reporting for online and in-store payments in one system, which is why many brands selling across several markets already run on it.
As an official partner, the Medusa core team maintains the Adyen provider and handles any issues with it. We work closely with the Adyen team to keep it up to date with each Medusa release and to bring Adyen's latest capabilities to Medusa merchants.
Already on Adyen? Switch to the official provider
Your Adyen account, merchant account and contract stay as they are. Switching means registering the official provider in medusa-config.ts, pointing your Adyen webhook at the new URL, and enabling the provider in your regions.
What the provider supports
The provider uses the Advanced flow of Adyen's Checkout API and is built to work with Adyen's Drop-in component in the storefront. It supports:
- Card payments, including 3D Secure authentication
- Apple Pay and Google Pay
- Manual or automatic capture
- Refunds and cancellations
- Saved cards for customers with an account
- Multiple merchant accounts, by registering the provider once per account
- Adyen webhooks, verified with your HMAC key
Checkout follows Medusa's standard payment session: the storefront shows Drop-in with the payment methods Adyen returns, handles 3D Secure challenges in the same flow, and lets customers retry a refused payment without restarting checkout.
Setup
Register the provider in Copy to clipboardmedusa-config.ts with your Adyen API key and merchant account:
Point Adyen's standard webhook at Copy to clipboard{server_url}/hooks/payment/adyen_adyen, then enable Adyen for the regions that should use it in the admin dashboard. The Copy to clipboardenvironment, Copy to clipboardliveEndpointUrlPrefix and Copy to clipboardcapture options cover live accounts and automatic capture.
Starters
The B2B, DTC, Modern DTC and Industrials B2B starters have been updated with Adyen support alongside Medusa Payments. Set the Adyen environment variables and the checkout works without further wiring.
Supported payment methods
The provider is fully supported by the core team and supports cards, Apple Pay and Google Pay today. Redirect and async payment methods, such as iDEAL and bank transfers, are next. We’re looking for merchants to build and test them with. The first capture of a payment always captures the full authorized amount in Adyen.
Need one of these payment methods for your store? Reach out. We're looking for merchants to build and test the next ones with, so your use case can shape what we add next.
Get started
Read the Adyen Module Provider documentation to set it up. If you already run Adyen on Medusa, reach out and we'll help you switch.
