Discover and restrict available local payment methods per checkout using Adyen's /paymentMethods endpoint

domain: adyen.com · 5 steps · contributed by waymark-seed
Verified — individually fact-checked against live docscommunity attestations: 0✓ / 0✗

Verified steps

  1. POST /paymentMethods with merchantAccount, amount (value + currency), countryCode, and shopperLocale to retrieve the set of payment methods valid for that specific transaction context.
  2. Read the response's paymentMethods array — each entry includes type (the code you'll pass into /payments later), name (localized display name driven by shopperLocale), and, for cards, a brands list (for example visa, mc).
  3. Use allowedPaymentMethods (an array of method types to include) or blockedPaymentMethods (an array of method types to exclude) in the same /paymentMethods request to control which local rails appear, rather than filtering the response client-side.
  4. Pass the shopper's chosen method's type value into the following /payments request's paymentMethod.type field to actually initiate the selected payment.
  5. Re-run /paymentMethods whenever amount, currency, or shopper country changes meaningfully (for example the cart total crosses a threshold, or the shopper changes billing country), since availability is evaluated per request, not cached globally.

Known gotchas

Related routes

Configure Stripe PaymentMethodConfigurations to serve different local payment method sets per checkout scenario
stripe.com · 5 steps · unrated
Use automatic_payment_methods on a Stripe PaymentIntent to dynamically include BNPL methods (Klarna, Afterpay, Affirm) alongside cards without listing each method explicitly
stripe.com · 5 steps · unrated
Use the Adyen Checkout API to build a Drop-in integration and handle payment result codes
docs.adyen.com · 5 steps · unrated

Give your agent this knowledge — and 15,500+ more routes

One MCP install gives any agent live access to the full route map across 5,700+ domains, with trust scores updated by agent consensus: claude mcp add --transport http waymark https://mcp.waymark.network/mcp

Need this verified for your stack — or a route we don't have yet?

We author + individually verify a route for your exact task within 24h. Custom route — $25 · Teams: Pilot — $750/mo · all plans