---
title: "Announcing Adyen Payments in Medusa"
description: "Medusa now ships with an official Adyen payment provider built and maintained by the core team. Learn how to set up cards, Apple Pay, Google Pay, and 3D Secure in your Medusa storefront."
url: https://medusajs.com/blog/announcing-adyen-payments-in-medusa
last_updated: 2026-11-10T10:35:26Z
---

# Announcing Adyen Payments in Medusa

_Published 2026-11-10 by Stevche Radevski in Product_

Medusa now ships with an official [**Adyen payment provider**](https://docs.medusajs.com/resources/commerce-modules/payment/payment-provider/adyen#content) supported by the core team. It is available in beta from [Medusa v2.22.2](https://github.com/medusajs/medusa/releases/tag/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](https://medusajs.com/contact).

## Medusa Adyen Partnership

[Adyen](https://www.adyen.com) 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.
>
> [Let's help you switch](https://medusajs.com/contact)

## What the provider supports

The provider uses the [Advanced flow](https://docs.adyen.com/online-payments/build-your-integration/advanced-flow/) of Adyen's Checkout API and is built to work with Adyen's [Drop-in](https://docs.adyen.com/online-payments/build-your-integration/advanced-flow/?integration=Drop-in&platform=Web) 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 `medusa-config.ts` with your Adyen API key and merchant account:

```typescript
{
  resolve: "@medusajs/medusa/payment-adyen",
  id: "adyen",
  options: {
    apiKey: process.env.ADYEN_API_KEY,
    merchantAccount: process.env.ADYEN_MERCHANT_ACCOUNT,
    hmacKey: process.env.ADYEN_WEBHOOK_HMAC_KEY,
    returnUrl: process.env.ADYEN_RETURN_URL,
  },
}

```

Point Adyen's standard webhook at `{server_url}/hooks/payment/adyen_adyen`, then enable Adyen for the regions that should use it in the admin dashboard. The `environment`, `liveEndpointUrlPrefix` and `capture` 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.

## Current limitations

The provider is in beta and fully supported by the core team. It supports cards, Apple Pay and Google Pay today. Payment methods that complete through a redirect or that Adyen confirms asynchronously, such as iDEAL and bank transfers, are not supported yet. 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](https://medusajs.com/contact). 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](https://docs.medusajs.com/resources/commerce-modules/payment/payment-provider/adyen) to set it up. If you already run Adyen on Medusa, [reach out](https://medusajs.com/contact) and we'll help you switch.