Help Center
DocsResponding to Disputes
Respond to Stripe chargebacks with evidence before the deadline so you can win the dispute and keep your funds
What Is a Dispute
How chargebacks work and when they appear in the CRM.
A dispute (also called a chargeback) happens when a customer asks their bank to reverse a charge after paying you via Stripe. Common reasons include fraud claims, "product not received", duplicate charges, or service quality complaints. When Stripe receives the chargeback, it withdraws the disputed amount from your balance and a draft dispute record appears at Payments > Disputes with status Draft. You respond with evidence; the card network reviews; Stripe returns the funds to you (status: Won) or to the customer (status: Lost).
Permission Requirement
Only roles with payments.disputes.respond can see or respond to disputes.
The Payment Disputes link in the sidebar is gated by the payments.disputes.respond permission. Without it, users do not see the page at all. By default, Super Admin and Admin roles hold this key; other roles must be granted it via Admin > Roles & Permissions.
Responding to a Dispute
Step-by-step evidence submission flow.
Open the Disputes page
Open the dispute detail page
Fill in evidence fields
Save the draft
Submit to Stripe
Evidence Fields
The six standard evidence fields and what each one covers.
| Field | Description |
|---|---|
| Service documentation | Link to the invoice, contract, signed quote, or service agreement that proves the customer agreed to the charge. Strongest evidence for most disputes. |
| Customer communication | Paste relevant emails, chat logs, or call notes that show the customer accepted the service or product. Particularly important for "product not received" disputes. |
| Receipt URL | A direct link to the Stripe receipt or your own custom receipt page. Demonstrates the customer was notified of the charge at the time it occurred. |
| Shipping documentation | Tracking number, carrier proof of delivery, or signature confirmation. Required for "product not received" disputes on physical goods. |
| Product / service description | Free-form description of what the customer purchased. Helps the reviewer understand the context, especially for B2B SaaS subscriptions where there is no physical product. |
| Additional explanation | Any other context that supports your case — refund policy, terms of service excerpt, screenshots of the customer using the product, etc. |
Dispute Status Meanings
What each status pill on the disputes list represents.
Draft (yellow) — Stripe has filed the dispute and is awaiting your evidence. The disputed amount is already withdrawn from your balance. You have until the Evidence due by date to respond.
Submitted (blue) — Your evidence is filed with Stripe and the card network is reviewing. You can no longer edit; you wait. Reviews typically take 30–60 days.
Won (green) — The card network ruled in your favor. The disputed amount returns to your Stripe balance on the next payout.
Lost(red) — The card network ruled in the customer's favor. The funds are not returned; the chargeback fee (typically $15–$25) also stays withdrawn.
Continuing in the Stripe Dashboard
When and why you might switch over to Stripe itself.
Some dispute responses need file uploads (PDF contracts, signed delivery photos) that the CRM's evidence form does not yet support. Every dispute detail page includes a Continue in Stripe Dashboard fallback link. Use it to attach supporting files; Stripe then merges those with the evidence you already filed via the CRM. The CRM will pick up the final dispute outcome via webhook.