Filing Requirements

Depending on dispute reason and card network, different fields and documentation must be present when you call the file endpoint for a case. Missing values produce a 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`

For the full list of recommended evidence per dispute type, see the Dispute Types documentation. For filing windows and earliest-filing dates, see Filing Timelines.

Getting Started

Core Concepts

Filing

Workflow and Validations

Mastercard

Required fields

Required documentation

Visa

Required fields

Required documentation

American Express

Required fields

Required documentation

​Mastercard

​Required fields

​Required documentation

​Visa

​Required fields

​Required documentation

​American Express

​Required fields

​Required documentation

Mastercard

Required fields

Required documentation

Visa

Required fields

Required documentation

American Express

Required fields

Required documentation