Maaz Zindani

Loading the index…

↑↓ move↵ openesc close4072 pages

Help for owners

Adyen is refusing customers' payments and nobody can tell me why

Short answer

When a bank or card scheme declines, it sends Adyen a raw response, and Adyen maps it to a refusal reason. The raw detail is hidden unless you switch on the Raw acquirer result setting. Retrying blindly can trigger scheme fees. Read the raw response and merchant advice code before changing anything in your checkout.

  • Written for business owners
  • Updated
  • By Maaz Zindani, Senior Software Engineer

Does this sound like your situation?

  • Many customers see a payment failed message and my dashboard just says Refused.
  • The refusal reason is generic and does not help me.
  • Declines rose after a change and I cannot tell if it is my site or the banks.
  • My developer retries failed payments automatically.
  • Some customers can pay and others with the same card type cannot.

Why does this happen?

  1. The bank decides, Adyen translates

    Adyen's documentation says that when a card scheme or issuer declines, it sends a raw acquirer response. Adyen maps it to a result code of Refused or Cancelled and a refusal reason. Adyen notes the raw responses differ between schemes and can change over time.

  2. The detail is off until you turn it on

    To receive the raw text, Adyen says to select Raw acquirer result under Additional data in the Customer Area. Declined payments then carry the full raw response, and the numeric part only for Visa and Mastercard on Adyen's own acquiring platform.

  3. Retrying the wrong declines costs money

    Adyen advises using the raw response in your retry logic to avoid Visa excessive retry fees. For Mastercard, the merchant advice code can say to get updated card details, retry after 72 hours, or not retry at all. Some Visa responses, such as closed account, say not to reattempt with the same card.

  4. Wording changes without notice

    Adyen warns that card schemes and issuers sometimes change raw response text without notice. Rules in your site that match exact wording can break silently.

  5. Raw details must not be shown to shoppers

    Adyen states that you must not expose raw response details to shoppers, to prevent malicious use. The customer message should stay general, so a vague message on screen is partly by design.

What can I do about it today?

  1. Collect a few failed paymentsWrite down the date, time, amount and the reference for five or six refused payments. A pattern, such as one card brand or one country, is the best clue.
  2. Ask whoever has Customer Area access to enable raw resultsUnder the merchant account, Developers, Additional data, select Raw acquirer result and save. New refusals then carry more detail.
  3. Stop automatic retries if you canIf your system retries refused payments in a loop, ask your developer to pause it until you know the reasons.
  4. Ask the customer to try a different cardOr to contact their bank. Adyen's data comes from the bank, and only the bank can explain its own decision.
  5. Do not show customers the raw reasonKeep the on-screen message simple, even if you find the cause.

When should I bring someone in?

  • Refusals are concentrated on one card brand, country or payment method and the raw detail does not explain it.
  • Declines started right after a change to the site or the Adyen settings.
  • You suspect your retry logic is repeating declines the banks said not to retry.

How do I handle it?

  1. Group the refusalsI sort a sample by reason, card brand, country, amount and payment type to see whether it is one cause or several.
  2. Separate bank declines from my own errorsI check whether anything on your side, such as wrong amounts or missing data in the request, could be causing refusals.
  3. Fix the retry rulesRetries are limited and driven by the merchant advice codes and raw responses Adyen documents, never repeated blindly.
  4. Write what to ask AdyenIf it still looks unexplained, I give you a short list of references and questions for Adyen support.

The price depends on what I find, so I quote in writing after a short discovery call. Tell me what is happening and I reply within 24 hours.

What do owners ask about this?

Can Adyen tell me the exact reason?

Adyen passes on what the bank sends. The raw response is more detailed than the refusal reason, but the bank makes the decision.

Why does the customer only see a generic message?

Adyen says raw response details must not be exposed to shoppers.

Should I just retry the payment?

Not blindly. Adyen's guidance ties retries to the raw response and the Mastercard merchant advice code, and retrying where it says not to can incur fees.

Sources

How was this page made?

I drafted this page with AI assistance from the official documents listed under Sources. Found a mistake? Tell me.

Next step

Want this off your desk?

Send me a few lines on where things stand. I reply within 24 hours.