400 response with parameter_missing or documentation_missing errors. This reference lists, per network, the requirements for each dispute type. Evidence beyond these requirements is also recommended, see Dispute Types.
Mastercard
Required fields
| Reason | Required fields |
|---|---|
fraud | issuer_evidence.card.is_active (must be false); at least one of issuer_evidence.fraud.was_reported or issuer_evidence.fraud.submit_report |
incorrect_amount | issuer_evidence.amount_correction.amount, issuer_evidence.amount_correction.currency |
Required documentation
| Reason | Required file category |
|---|---|
incorrect_amount | transaction_receipt |
Visa
Required fields
| Reason | Required fields |
|---|---|
fraud | issuer_evidence.card.is_active (must be false); at least one of issuer_evidence.fraud.was_reported or issuer_evidence.fraud.submit_report |
product_not_received | issuer_evidence.delivery.expected_date, issuer_evidence.merchant_contact.date |
subscription_canceled | issuer_evidence.cancellation.date, issuer_evidence.merchant_contact.date |
product_not_as_described | issuer_evidence.delivery.date, issuer_evidence.merchant_contact.date |
credit_not_processed | issuer_evidence.refund.promise_date |
incorrect_amount | issuer_evidence.amount_correction.amount, issuer_evidence.amount_correction.currency |
product_counterfeit | issuer_evidence.delivery.date |
canceled_or_returned | issuer_evidence.delivery.date or issuer_evidence.delivery.expected_date, issuer_evidence.merchant_contact.date |
Required documentation
| Reason | Required file category |
|---|---|
credit_not_processed | refund_promise (credit transaction receipt, voided transaction receipt, or other proof of credit due) |
incorrect_amount | transaction_receipt |
product_counterfeit | counterfeit_evidence (e.g. photo of counterfeit item, third-party verification) |
American Express
Required fields
| Reason | Required fields |
|---|---|
fraud | issuer_evidence.card.is_active (must be false); at least one of issuer_evidence.fraud.was_reported or issuer_evidence.fraud.submit_report |
incorrect_amount | issuer_evidence.amount_correction.amount, issuer_evidence.amount_correction.currency |
Required documentation
| Reason | Required file category |
|---|---|
incorrect_amount | transaction_receipt |