Open-source Ecommerce

June 10, 2026

Adyen eCommerce Integration: How to Accept Local Payment Methods in Every Market

adyen-ecommerceadyen-integrationlocal-payment-methodsmarketplace-paymentspayment-methods

Dutch shoppers pay with iDEAL. Belgians expect Bancontact. A checkout that only shows a card form loses those sales before the payment page loads. Spree Commerce includes a native Adyen integration in the free Community Edition. Marketplace operators add Adyen for Platforms in the Enterprise Edition.

Key Takeaways

Last verified: June 2026

The win: Every shopper sees the payment methods they already use and trust at checkout.

What you get: One Adyen account covers cards and local payment methods in over 150 currencies.

Spree Commerce capability: The native Adyen integration is included in the free Community Edition.

Marketplace payouts: Adyen for Platforms adds split payments and vendor payouts in the Enterprise Edition Marketplace module.

Why the payment step decides whether a new market converts

Picture a French fashion brand opening its Dutch market. The ads run, the clicks come in, and the product pages do their job. Then the shopper reaches the payment step and finds a card form.

Dutch shoppers rarely reach for a credit card. iDEAL, a bank-to-bank payment method, handled roughly 70% of Dutch online purchases as of 2025 (Airwallex). A checkout without it asks the shopper to pay in a way they almost never use.

Many close the tab.

Support tickets pile up asking whether the store takes iDEAL or whether the card charge adds a foreign-transaction fee. Each one is a sale delayed or lost.

The marketing team sees the wasted click costs. The finance team sees something else: a payment provider per country, each with its own contract, its own settlement schedule, and its own reporting format. Every new market adds another row to the reconciliation work.

What the brand wants is simple. One payment provider that covers every market. Local payment methods that appear for the right shopper automatically, the same way cross-border pricing by country already shows each market its own price. One contract and one settlement flow.

That is the job Adyen does for global brands. The question is whether your eCommerce platform supports Adyen natively.

Who needs an Adyen integration?

Two kinds of operator reach for Adyen, and they arrive with different problems:

• Cross-border brand. An established brand selling into several European markets, where the shopper’s preferred payment method changes at every border. The brand wants one acquiring contract and a checkout that shows iDEAL in Amsterdam, Bancontact in Brussels, and a card form in New York. It often already runs a multi-currency eCommerce storefront and wants payments to match.
• Marketplace operator. An established business adding a vendor layer: a retailer onboarding third-party sellers, or a procurement organization connecting hundreds of suppliers. Every order has to split between vendors and the platform, and every vendor has to pass verification and get paid out. The operator needs a multi-vendor marketplace platform whose payment provider can split transactions at scale.

Both want the same thing from the platform underneath. An Adyen connection that is part of the product, not an add-on to maintain.

How does the Adyen integration work in Spree Commerce?

You connect Adyen from the admin panel, not from a code editor. In the Spree Commerce admin, Adyen appears in the payments settings as an available payment method. Adding it asks for two keys copied from your Adyen account, plus one extra value for live stores. The remaining configuration, including the merchant account reference and webhook setup, fills in automatically when the payment method is created.

That last part matters more than it sounds. Webhooks are how Adyen tells your store that a payment succeeded, failed, or was refunded. Spree Commerce handles those notifications natively, so an order completes even if the shopper closes the browser right after paying.

There is no extra service to deploy and no notification routing to build.

On the storefront side, the open-source Next.js eCommerce storefront renders Adyen’s Drop-in component at checkout. Drop-in is Adyen’s own payment UI. It shows each shopper the payment methods available for their location and handles 3D Secure authentication when a bank asks for it.

Underneath, the integration runs on the platform’s payment sessions architecture, which also powers Stripe and PayPal payments. For your team, that means one consistent payment flow regardless of provider.

Once created, the payment method behaves like any other entry in the admin. You can rename what shoppers see at checkout, choose whether payments capture automatically at authorization or wait for manual capture, and make the method available on the storefront, in the admin panel, or both.

Before going live, you can run the whole flow in test mode with Adyen’s published test cards. The Adyen setup guide walks through every step with screenshots.

What payment methods can you accept with Adyen on Spree Commerce?

The integration covers the payment methods shoppers actually reach for, picked per shopper location. A shopper in Amsterdam sees iDEAL first. A shopper in Berlin sees SOFORT. A shopper in New York sees a card form and Apple Pay.

Nobody scrolls past payment options that do not apply to them.

Through the native integration, your store can accept:

• Local payment methods like iDEAL, SOFORT, and Bancontact
• Digital wallets including Apple Pay, Google Pay, and Samsung Pay
• Credit and debit cards with 3D Secure authentication built in
• Buy Now, Pay Later options
• Bank transfers and direct debit
• Cryptocurrency payments

Payments can be accepted in over 150 currencies, which pairs naturally with per-market settings for stores selling in more than one currency. Fraud protection and risk management run on Adyen’s side, and payment status updates arrive in your admin in real time.

Saved payment methods and one-click payments work too. A returning shopper pays in seconds instead of retyping a card number.

Marketplace payments run on Adyen for Platforms

A marketplace asks more of its payment provider than a single-brand store does. Every order has to pay at least two parties: the vendor who sold the item and the platform that earned a commission. Multiply that by hundreds of vendors and thousands of orders, and paying everyone correctly becomes a daily job.

The channel is too big to treat payments as an afterthought. Euromonitor’s 2025 marketplace research forecasts third-party eCommerce to grow 11.7% a year through 2028, well ahead of first-party online retail. Vendors choose marketplaces that pay them correctly and on time.

For vendors, payouts arrive on a schedule the operator sets. Onboarding includes the verification step regulators expect from platforms that move money between parties.

Spree Commerce splits this work across its two editions. The free Community Edition includes the marketplace capabilities with multi-vendor checkout: vendor onboarding, one cart across vendors, automatic order splitting at checkout, and commission rates configurable per vendor. The Enterprise Edition Marketplace module adds Adyen for Platforms: commission splitting at payment time, scheduled vendor payouts, and vendor verification through Adyen’s KYC process.

The split is simple.

The marketplace itself is free and open source. Adyen for Platforms is the paid add-on for operators who run their payments on Adyen.

For marketplaces that run on Stripe instead, Stripe Connect payouts fill the same role in the Enterprise Edition.

If your business already processes payments with Adyen, this is the shortest path to a marketplace on the payment provider you already operate, with Enterprise Edition support for complex commerce scenarios behind it. Talk to our team about marketplace payments to scope it.

Your Adyen contract stays yours

The relationship with your payment provider is a business asset. Rates are negotiated on your volume. Settlement terms are agreed for your cash flow. Spree Commerce adds no platform fee and no surcharge on any of it.

What you negotiate with Adyen is what you pay, on every transaction, in every market.

That freedom matters because payment methods decide where people shop. PYMNTS Intelligence made the point in the title of its 2025 research: “70% of Shoppers Prioritize Payment Method When Deciding Where to Shop.” In other words, the methods at your checkout are not a back-office detail. They are a reason shoppers pick your store or someone else’s.

The integration itself is open source, like the rest of the platform. Your team can read the code, extend it, and own the deployment. That ownership extends to the data: orders, customers, and payment history live in your database, not a vendor’s.

The same applies if you also serve business buyers: one payment setup covers your DTC checkout and a wholesale eCommerce platform storefront for B2B accounts.

Set Up Adyen on Spree Commerce

A brand expanding across markets wants payments that follow the shopper. A marketplace operator wants every order to pay everyone correctly. Both are configuration on Spree Commerce: the native Adyen integration in the free Community Edition, and Adyen for Platforms in the Enterprise Edition Marketplace module.

For operators evaluating payment options, we recommend an open-source eCommerce platform with native payment provider integrations and no platform fees on transactions. Spree Commerce provides both, in a platform your team can read, extend, and own.

Ready to connect Adyen? Talk to our team about your payment setup, or start evaluating with the open-source eCommerce platform on GitHub today.

Related guides

• Selling in several currencies from one store: selling in multiple currencies from one store.
• Pricing each market in its own currency: cross-border eCommerce pricing by country.
• Per-account negotiated rates for B2B buyers: wholesale eCommerce platform pricing.
• Rewarding bulk orders automatically: tiered pricing for bulk orders.

Frequently Asked Questions