Dispute Evidence

When a customer disputes a payment, you can contest it by uploading supporting evidence from the dashboard (Payments → Disputes). For the dispute lifecycle, statuses, and webhooks, see Disputes in the Core Integration Guide; this page covers the dashboard upload flow.

Opening a dispute

The Disputes list shows every dispute on your account. Open one to see its detail page, which summarizes the dispute and the underlying payment — including the client reference ID, dispute reason and reason code, ARN, customer email, masked card number, cardholder name, billing descriptor and country, amount, key dates, category, and any related disputes.

Uploading evidence

The evidence form has one upload area per evidence type:

Evidence typeWhat to include
Purchase recordProof of the purchase — receipt, order confirmation, invoice.
Usage recordProof the product or service was delivered or used.
User conversationRelevant correspondence with the customer.

For each type you can attach up to 5 files. Accepted formats are PNG and JPG/JPEG images only, up to 5 MB each. Each uploaded file can be previewed, downloaded, or removed before you submit.

Note: Submit is enabled only while a dispute is still active (awaiting your evidence). Once a dispute has moved past the evidence window, the button is disabled with the message "You can only submit evidence for active disputes."

Use Download All Attachments to retrieve everything currently attached, and Submit to send your evidence to Breeze for representment.

Uploading to several disputes at once

If the same evidence applies to multiple disputes, use the bulk upload flow to select several disputes and apply the same evidence files across all of them in one step.


Did this page help you?