Skip to main content
Every dispute is filed under one reason, sent as reason on POST /disputes. The reason drives how the card network handles the dispute, so the closest match matters more than a quick pick. File a Dispute covers the filing steps. category is derived from the reason and returned on the dispute, so you never send it. It names the group the reason belongs to, one of the four below. Use it to organize a reason picker, and as a filter on GET /disputes. Every reason shares the same filing window. File a Dispute states the window and the other requirements.

Fraud

The cardholder did not authorize the charge. Use FRAUD_OTHER_CARD_PRESENT when you know the transaction was fraudulent and the card was used in person, but not how the card was compromised. Use FRAUD_OTHER_CARD_ABSENT for the same situation online. A confirmed fraud alert of type ACCOUNT_NUMBER_MISUSE matches this reason when the cardholder still holds the card. The two FRAUD_EMV_LIABILITY_SHIFT_* reasons carry a condition beyond the kind of fraud. They apply only where the merchant terminal lacked the chip or PIN capability that would have prevented the transaction, which is what shifts liability to the merchant. Where the terminal was fully capable, file the same fraud as FRAUD_OTHER_CARD_PRESENT instead.

Authorization

The merchant took the charge without valid authorization. AUTHORIZATION_NO_AUTH_LATE_PRESENTMENT covers both situations under one reason. Use it whether the authorization was missing entirely or the merchant settled too late.

Processing error

The charge was processed incorrectly.

Consumer

The cardholder authorized the charge, but the merchant did not meet its obligations. CONSUMER_CREDIT_NOT_PROCESSED and CONSUMER_CANCELLED_MERCHANDISE are the pair most often confused. Use the first when the merchant agreed to refund and never did. Use the second when the cardholder canceled or returned the goods under the merchant policy and no refund followed.

Next steps

File a Dispute

Check the requirements, file the dispute, and track it to resolution.

Lifecycle and Statuses

Every status value, what to do about it, and how the refund is calculated.