Skip to content
Merchant CasefileEvidence systems for online sellers.
chargebacks
reason codes
evidence

Chargeback Reason Codes, Explained

June 25, 20264 min readBy Merchant Casefile

Quick answer

What chargeback reason codes are, why they decide which evidence actually matters, and how to find and read yours across Visa, Mastercard, and your provider.

Every chargeback arrives with a reason code — a short label the cardholder's bank uses to say why the payment is being disputed. It's easy to skip past it and start pulling screenshots, but the reason code is the most important thing on the notice: it decides which evidence is relevant and which is just noise.

This guide explains what reason codes are and how to read yours. As always, organizing your response well never guarantees an outcome — the cardholder's issuing bank and the card networks make that call — but matching your genuine records to the exact reason is how you give a clear, complete response instead of a scattered one.

What a reason code actually is

When a cardholder disputes a charge, their bank files it under a standardized code defined by the card network (Visa, Mastercard, American Express, Discover). The code is a category: "merchandise not received," "transaction not recognized," "not as described," "duplicate processing," and so on. Your payment provider then surfaces that code (or its own plain-language version of it) when it asks you to respond.

The codes differ by network and they change periodically, so don't memorize numbers. What matters is the category the code falls into, because each category expects completely different evidence.

Why the category decides your evidence

A response that's strong for one reason is irrelevant for another. Proof of delivery is the heart of a "not received" case — and almost useless for an "unauthorized" one, where the bank cares about who placed the order. So before gathering anything, sort your dispute into one of these broad buckets:

CategoryWhat the bank is questioningEvidence that's relevant
Fraud / unauthorized"I didn't make or authorize this."AVS & CVV match, IP/device, account & order history, delivery to the cardholder
Not received"It never arrived."Tracking, proof of delivery, shipping timeline, order details
Not as described / defective"It wasn't what was advertised."Product listing as shown, policies accepted, communication, resolution offered
Processing error"Wrong amount / charged twice / already refunded."Order and refund records, billing logs, the single authorized charge
Subscription / recurring"I cancelled / didn't expect this renewal."Sign-up record, terms accepted, renewal notices, cancellation policy

If you handle digital products, the same logic applies — your evidence trail is just access logs and delivery records rather than parcels.

Where to find your reason code

The reason code (and your response deadline) lives in the dispute notice inside your payment provider's dashboard — the Stripe Dashboard, the PayPal Resolution Center, your Shopify admin, and so on. Open the disputed transaction and read the stated reason and the submit-by date before anything else. If the deadline isn't obvious, a deadline calculator can help you estimate the window.

You can also tell whether you're looking at a true chargeback, a softer inquiry, or a provider dispute — they're handled slightly differently, which we cover in chargeback vs dispute vs inquiry.

Matching your records to the reason

Once you know the category, the work is the same calm routine every time:

  1. Note the deadline and work backward from it.
  2. Gather only the genuine records that match the reason — don't pad the response with irrelevant documents.
  3. Lay them out in order with a short, neutral cover summary and a numbered index.
  4. Submit it yourself through your provider before the deadline.

The free Dispute Evidence Builder does exactly this sorting for you: pick your dispute type and provider, and it returns a tailored checklist of the records that matter for your reason.

A note on honesty

The reason code tells you what to prove — it doesn't tell you to stretch the truth. If the records you genuinely have don't support your case, no amount of organizing changes that, and altering or inventing anything is both wrong and self-defeating. A clear, factual response built on real records is the only kind worth submitting.

Merchant Casefile provides organizational tools and educational resources. It does not provide legal, financial, banking, or payment-processor advice, and does not guarantee dispute outcomes.

Turn this into a real case file

Use the free Dispute Evidence Builder to see exactly what to gather, grab a template kit, or have us organize a dispute-ready package for you.

Honest-by-design

Merchant Casefile provides organizational tools and educational resources. It does not provide legal, financial, banking, or payment-processor advice, and does not guarantee dispute outcomes.