How to Win a WooPayments Dispute: Deadlines, Fees & Evidence

WooPayments puts disputes right inside your WordPress admin, which makes them easy to find and easy to underestimate. Underneath is the same card-network process every Stripe merchant faces: funds pulled immediately, a fee, a short deadline, one submission, and a bank you never talk to making the call. Here’s how the process works and how to win more of it. All WooPayments specifics below come from WooCommerce’s own documentation as of November 2026.

How WooPayments disputes work

WooPayments is WooCommerce’s built-in payment gateway, built in partnership with Stripe. When you sign up, WooPayments creates a special Stripe Express account for you, and the dispute mechanics follow Stripe’s model. The difference is where you work: you respond inside WP Admin, not in a Stripe Dashboard.

When a cardholder disputes a charge with their bank:

1. The issuing bank opens a chargeback. The disputed amount and the dispute fee are debited from your WooPayments balance immediately.
2. You’re notified by email, by an alert on the order under WooCommerce > Orders, and by a red bubble next to Payments > Disputes.
3. You accept or challenge. Challenging with evidence is the only way to recover the funds and the fee.
4. The cardholder’s bank decides. Not WooCommerce, not Stripe. WooPayments packages your evidence and forwards it; the issuer rules.

That last point shapes everything. You’re not persuading WooCommerce support. You’re building a file that a bank reviewer who has never heard of your store can rule on quickly.

Where to find and respond to disputes

Go to Payments > Disputes. By default the list shows only disputes that still need a response, sorted with the nearest deadline at the top. Click a dispute to open its transaction details page, which shows the amount, the dispute reason, customer information, and two buttons: Accept dispute and Challenge dispute.

Clicking Challenge dispute opens a three-step form:

Two behaviors to know:

• The cover letter doesn’t update itself. If you type into the cover letter box, your text overrides the template, and later edits to earlier steps won’t flow into it. Finish the earlier sections first.
• Save for later is a safety net, not a strategy. It stores progress without submitting. If you never come back, WooPayments submits the saved evidence automatically on the deadline date, which is better than nothing but rarely your strongest file.

A payment with more than one dispute shows each in its own numbered section (“Dispute 1 of 2”), and each must be answered separately.

Accept or challenge?

Before you decide, contact the customer and keep a record of the conversation. WooCommerce notes that customers sometimes withdraw the dispute with their bank once the issue is cleared up, though you still need to challenge it to get the money back (more on that below). Accepting is not an admission of wrongdoing, and it’s the right call when you have no evidence that addresses the reason, such as an order that genuinely never shipped. Challenge whenever the order was legitimate and you can document it: that’s the only path to recovering both the disputed amount and the fee. If you’re unsure whether a low-value case is worth the time, see should you fight small chargebacks.

Deadlines

You usually have about 7 to 21 days from when the dispute is filed. The exact date is on the dispute. After you submit, the cardholder’s bank typically takes 60 to 75 days to decide. Cardholders can generally file up to 120 days after the charge, sometimes longer, so a dispute can arrive months after the sale. For how these windows fit together, see chargeback time limits.

You get one submission. After you click Submit, you can’t update the dispute or add evidence. Gather everything first, review once, and submit a few days before the deadline.

The WooPayments dispute fee

WooPayments charges a flat fee per dispute, debited the moment the dispute arrives:

The important detail: WooPayments refunds the fee automatically if you challenge and win. Lose, or accept, and the fee stays with the issuer. This differs from a direct Stripe account, where the dispute received fee isn’t returned even on a win. More on how processors compare in chargeback fees by processor.

One special case: Visa compliance disputes (reason “Non-compliant”) are filed by the issuing bank rather than the customer. Challenging one requires agreeing to an extra $500 fee, returned only if you win. WooCommerce recommends accepting these unless you have clear proof of compliance.

Evidence by dispute reason

WooPayments shows a dispute reason on every case, and the right evidence depends on it. Here’s a condensed version of WooCommerce’s evidence guidance, with the closest card-network reason codes:

The prior-undisputed-transactions point is the one most merchants miss. On Visa fraud disputes it is the core of Visa’s Compelling Evidence 3.0 rules; see compelling evidence for how that works.

WooCommerce’s formatting rules also cost merchants cases when ignored:

• One file per field. Combine screenshots into a single PDF.
• PDF, JPEG or PNG only, under 4.5 MB combined, under 50 pages (19 for Mastercard).
• No links, audio or video. Banks won’t follow or review them; everything must be in the files.
• Crop and annotate. Box or arrow the delivered status, the matching address, the accepted checkbox.
• Check the pre-filled fields. Billing address, name, email and IP are auto-filled; make sure they’re right.

Inquiries are not disputes

WooPayments also surfaces inquiries, a pre-dispute step used mainly by American Express and Discover (sometimes called a retrieval or request for information), usually because the cardholder doesn’t recognize the charge. Three things make them worth handling fast:

• You can resolve an inquiry without the dispute fee by sending evidence the cardholder made the payment or by issuing a full refund.
• Inquiries can’t be withdrawn by the customer.
• If you don’t respond, the issuer may convert the inquiry into a dispute you can’t win.

Common mistakes that lose WooPayments disputes

• Refunding outside the dispute. The disputed amount is already gone. A separate refund can cost you about twice the amount. See chargeback after a refund.
• Not challenging a withdrawn dispute. Even if the customer tells their bank to drop it, you still need to challenge with evidence to recover the funds and fee. Withdrawn disputes also still count toward your dispute rate.
• Submitting before the file is complete. One shot means a rushed response is a permanent weakness.
• Generic evidence. Tracking won’t win an unauthorized dispute; AVS and order history won’t win a not-received one.
• Emotional or legal-threat cover letters. Keep it to a short, factual summary that points at the decisive evidence.
• Ignoring the dispute rate. Network thresholds apply to WooPayments merchants too. See what is a good chargeback ratio.

Where DisputeDash fits

Most of what decides a WooPayments dispute lives in your WooCommerce store: the order, the customer’s IP, the addresses, the order notes, any refund. Getting it into the right form before the deadline is the hard part.

To be clear about scope: DisputeDash does not submit responses inside WooPayments. Its WooCommerce integration connects with a REST API key and pulls order and line-item data, customer profile and IP, billing and shipping addresses, payment method, order notes, refunds, and tracking numbers when your store records them. That data feeds automated responses for disputes on the processors DisputeDash connects to, such as Stripe, PayPal and Braintree. If your store takes payments through one of those (for example, a regular Stripe account via WooCommerce’s Stripe extension), DisputeDash gathers the WooCommerce evidence and submits before the deadline on a flat monthly fee with no commission. If you stay on WooPayments, use the checklist above inside WP Admin.

Bottom line

Winning a WooPayments dispute takes three things: evidence that matches the dispute reason, a clean three-step submission with a factual cover letter, and doing it once, completely, before a 7 to 21 day deadline. Unlike a direct Stripe account, a win returns the fee as well as the funds, so every legitimate dispute you fight well is worth more than it looks.