What we do
Tools
Industries
Department
How we workLet's talk →
Home/Adyen/Adyen Payment Methods
Adyen

Adyen Payment Methods: Which Ones a Shopper Sees, and Why One Goes Missing

A customer in Amsterdam emails to ask why there's no iDEAL at checkout, when you're sure it was switched on. On Adyen, a method only appears when three things agree: your account has it, the checkout request describes a shopper it works for, and your front end renders it. Here's each layer, starting with which methods matter where.

Local payment methods worth offering by market

Cards and wallets such as Apple Pay and Google Pay travel well. These are the local methods shoppers in each market look for. Confirm in Adyen's payment method docs what your account can offer.

Selling to Methods shoppers expect Watch for
Netherlands iDEAL, alongside cards iDEAL only takes euros, so the amount in the request has to be in EUR.
Belgium Bancontact Also euro-only.
Poland BLIK Needs a PLN amount.
Brazil Pix and boleto BRL amounts. Ask Adyen early whether your setup can offer them.
Switzerland TWINT CHF amounts.
Sweden Swish, plus Klarna SEK amounts.
US and UK Cards, Apple Pay, Google Pay, PayPal, and buy now, pay later such as Klarna Buy now, pay later methods often go through their own onboarding before they go live.

From requesting a method to seeing it at checkout

  1. 1

    Request it in the Customer Area

    Settings Payment methods Request payment methods

    Search for the methods you want and add several at once. Some go live directly; others open a case with Adyen first. You need the Change payment methods role to do this. The Management API can request methods too.

    Watch for: the request is asynchronous. A method you asked for this morning may not be active yet.

  2. 2

    Set where it can be offered

    Each method's settings in the Customer Area include the countries or regions it's available in. Narrow it there if a method should only ever appear in one market.

  3. 3

    Ask for the list at checkout

    Your server calls /paymentMethods with your merchantAccount, the shopper's countryCode, the amount (currency plus value in minor units), the channel (Web, iOS or Android) and shopperLocale. Adyen returns only the methods that fit that shopper. On the Sessions flow, the same details go on the /sessions request.

    Watch for: allowedPaymentMethods and blockedPaymentMethods. They let one request show or hide methods by type, which is how per-market or per-basket rules get applied.

  4. 4

    Render what came back

    Drop-in shows the whole returned list in one block. With Components you mount one method at a time, in the order and layout you choose.

Switched on in the Customer Area, absent at checkout

The currency in the request is wrong

How you'll know: A local method shows in testing for one market and never for another.

Fix: Local methods are tied to their currency. Send the shopper's currency in amount, not your home currency.

countryCode is missing or set from the wrong field

How you'll know: Every shopper sees the same short list.

Fix: Pass the shopper's country, usually from billing or shipping address or a country picker, rather than your company's country.

The method is still pending

How you'll know: It's listed in the Customer Area but never comes back from /paymentMethods.

Fix: Check whether the request opened a case that's waiting on you or on Adyen. Methods with their own onboarding stay off until it finishes.

Your code hides it

How you'll know: The API response includes it, but the page doesn't.

Fix: Look for a blockedPaymentMethods list, an old allowedPaymentMethods list, or front-end config that filters methods after the response.

Apple Pay only shows on some devices

How you'll know: Testers on Windows or Android never see it.

Fix: That's expected: Apple Pay appears only where the browser and device support it. For it to work live on the web, each domain also has to be verified with Apple's domain association file.

Drop-in or Components for showing payment methods

Drop-in

One block, every returned method

  • Renders the full list from /paymentMethods or your session.
  • Quickest way to add a new market: request the method and it appears.
  • Order and grouping follow Adyen's defaults, with some styling options.
Components

One method at a time, your layout

  • You choose which returned methods to mount and where.
  • Suits a checkout that already has its own design and step order.
  • Each new method means a little more front-end work.

Both come from Adyen Web, so this is a front-end choice. What decides which methods are offered is still the request your server sends.

Adyen payment method questions

How do I enable Apple Pay on Adyen?

Request it in the Customer Area like any other method. For the web, you can use Adyen's Apple Pay certificate or your own Apple merchant identifier, and each live domain has to be verified by hosting the domain association file at /.well-known/apple-developer-merchantid-domain-association. A test account doesn't need the file.

Does Adyen support Klarna and other buy-now-pay-later methods?

Yes. Klarna is among the buy now, pay later methods you can request through the Customer Area, and like several methods it may go through its own onboarding before it's live. Once it is, it comes back from /paymentMethods for shoppers in the countries and currencies it supports.

Can I show different payment methods to customers in different countries?

Yes. Adyen already filters by the countryCode and currency you send, and you can limit a method's countries in its Customer Area settings. For rules Adyen doesn't know about, like hiding a method on low-value baskets, send allowedPaymentMethods or blockedPaymentMethods on each request.

What's the difference between Adyen Drop-in and Adyen Web?

Adyen Web is the JavaScript library. Drop-in is one way of using it: a single block that renders every method Adyen returns. Components are the other way, mounting one method at a time for more control over layout.

Does adding more payment methods cost more with Adyen?

Each transaction carries a processing fee plus a fee for the payment method used, and that fee differs by method. Cards are priced on interchange++. Adding a method doesn't cost anything until it's used, but your blended rate shifts with the mix, so check Adyen's pricing page for the methods you plan to offer.

Which payment methods does Adyen support in my country?

Adyen's payment method docs list each method with its countries and currencies, and the Management API returns the countries a method is available in for your account. For a live answer per shopper, call /paymentMethods with their country and currency.

Let's talk

Tell us the one thing your team does manually that eats up time. We read every message and reply within a day.