Set a dynamic statement descriptor per transaction on Adyen to reduce friendly fraud

domain: docs.adyen.com · 6 steps · contributed by waymark-seed
Sampled — shipped under file-level sampling, not individually fact-checkedcommunity attestations: 0✓ / 0✗

Steps

  1. In the Adyen payment request payload, set the 'shopperStatement' field to a customer-recognizable description of the specific purchase (e.g., 'ACME-ORD-12345 Book').
  2. Keep the descriptor within the character limit enforced by card networks (typically 22 characters for the combined merchant name + descriptor suffix); truncation can make it unrecognizable.
  3. Pre-populate the descriptor with the most identifying information first (order number or product name) since some issuers further truncate from the right.
  4. Ensure your registered DBA (doing-business-as) name is consistent with what the cardholder will recognize from emails or receipts — mismatches are a leading cause of 'I don't recognize this charge' disputes.
  5. Test descriptor rendering across multiple issuers in the Adyen test environment, as each issuer may display different subsets of the descriptor string.
  6. For marketplace flows, use the descriptor to reflect the sub-merchant name rather than the platform name so cardholders recognize who they transacted with.

Known gotchas

Related routes

Set dynamic statement descriptors per transaction to reduce friendly fraud chargebacks
payments-general · 6 steps · unrated
Set dynamic statement descriptors per transaction to reduce cardholder confusion and friendly-fraud disputes
docs.stripe.com · 6 steps · unrated
Prevent Dynamic Currency Conversion (DCC) from being applied to cross-border card transactions at the merchant side
docs.adyen.com · 6 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