Skip to main content
Card class: HeroCategory: Payment Gateway
Disputes in needs_response or warning_needs_response, clock is ticking on evidence.

At a glance

Real-time count of Stripe disputes that require merchant action. Specifically status IN ('needs_response', 'warning_needs_response'), both states have a hard 7-day evidence-submission deadline (10 days for early-warning chargebacks). A missed deadline equals an automatic loss; the funds are debited from the merchant’s Stripe balance plus a $15 dispute fee. The card answers “how many evidence packs are due right now”.
What it countsCOUNT(disputes WHERE status IN ('needs_response', 'warning_needs_response')). Each open dispute increments the count by one regardless of value.
needs_response vs warning_needs_responseneeds_response = a formal chargeback has been filed and the merchant must submit evidence within ~7 days. warning_needs_response = an early-warning notification (typically Visa Rapid Dispute Resolution or Mastercom Collaboration) where the merchant has a chance to refund pre-emptively before the formal chargeback files.
Currencyn/a for the count. Per-dispute amounts are surfaced in the dispute’s currency field.
Fees / processing costn/a for the count. Each lost dispute typically adds a $15 dispute fee on top of the disputed amount.
RefundsA merchant who refunds before the dispute is filed avoids the chargeback entirely; once the dispute is in needs_response, refunding does NOT close it (the dispute proceeds independently).
Disputes / chargebacksThis card measures disputes.
Failed / declined paymentsn/a, disputes apply only to successful charges.
Payout timingOpen disputes hold the disputed funds in the Stripe balance; the funds are released back if the dispute is won and debited if lost.
Page capAPI page cap of 1,000 disputes per refresh. Most merchants have far fewer than 1,000 open disputes; if you do, you have a much bigger problem.
Time windowRT (real-time, refreshed at API sync interval)
Alert trigger>0, the alert is binary; any open dispute deserves attention because the deadline clock is running.
Rolesowner, finance, operations

Calculation

Calculated automatically from your Stripe data. See the At a glance summary above for what the metric tracks and the worked example below for a typical reading.

Worked example

A US DTC apparel brand on Shopify + Stripe, monthly volume ~$420,000 across ~3,200 charges. Reading at 14:00 UTC on 12 Apr 26.
StatusCountTotal disputed (USD)Days remaining (median)Reason mix
needs_response (formal chargeback)8$1,8404 daysfraudulent (4), product_not_received (2), unrecognized (2)
warning_needs_response (early warning)3$6207 daysfraudulent (2), unrecognized (1)
under_review (evidence submitted, awaiting decision)4$1,140n/a(informational, not in this card)
Open Disputes (this card)11$2,460
What’s interesting:
  1. The card alerts at >0, so 11 is a 5-alarm operational fire. Each open dispute is a deadline. The 8 formal chargebacks have a median 4 days remaining; missing those deadlines means losing 1,840plus8×1,840 plus 8 × 15 = 120indisputefees,total120 in dispute fees, total 1,960 at stake.
  2. The 3 early-warning disputes are the highest-leverage subset. Visa RDR and Mastercom Collaboration disputes are pre-chargeback, the merchant can refund the customer pre-emptively (full or partial) and the chargeback never files. The cost is the refund itself; the avoided cost is the chargeback (which counts against the merchant’s chargeback rate threshold of 0.9% / 1.5% with card networks). For low-value cases, refunding is almost always cheaper than fighting.
  3. fraudulent is the dominant reason (6 of 11). This signals true fraud (stolen card used at checkout) where chargeback win rate is structurally low (<10% even with strong evidence). The right action is usually to document the case for Stripe Radar tuning rather than fight; pair this card with Radar Score Distribution to identify whether Radar is letting through cards it should be blocking.
  4. product_not_received and unrecognized are winnable. These have higher win rates (40 to 70%) with strong evidence: shipping carrier delivery confirmation, customer email correspondence, IP-address-at-purchase logs. Each takes 30 to 60 minutes of evidence-pack assembly; at 230averagepercase,thats230 average per case, that's 230/hour effective time-saved if won.
  5. **The total at-risk is 2,460+ 2,460 + ~165 in dispute fees = 2,625.Ona 2,625.** On a ~420,000/month merchant, this is 0.6% of monthly revenue tied up in disputes. The chargeback-rate threshold is 0.9% (Visa) / 1.5% (Mastercard) of total transactions; at 11 open disputes against ~3,200 charges this merchant is at 0.34% chargeback rate, well below threshold but worth monitoring.
The actionable read: triage today by deadline-remaining. The 4-day-deadline cases must be handled before end-of-week; submit evidence for the winnable cases (product_not_received, unrecognized), refund the early-warning cases pre-emptively, and accept losses on most fraudulent cases unless evidence is unusually strong.

Sibling cards merchants should reference together

CardWhy pair it with Open Disputes
Dispute RateThe trend view. The card is the count “right now”; the rate is the volume-weighted trend over time.
Dispute ValueThe financial weight. 11 disputes at 50averageisdifferentfrom11disputesat50 average is different from 11 disputes at 500 average; the value card is the right view for finance prioritisation.
Dispute Win RateThe historical performance. Useful for decision-making: “is it worth fighting fraudulent cases?” The win rate by reason answers it.
Dispute ReasonsThe categorisation. Reason mix tells you the class of issue: fraud (Radar tuning), product issues (CX team), shipping issues (fulfilment ops).
Dispute Response TimeThe operational metric. How fast does the merchant submit evidence after a dispute opens? Faster response correlates with higher win rate.
Dispute Rate TrendThe leading-indicator view. A dispute-rate trend rising before chargeback-rate threshold breach is the early warning.
Chargeback ForecastThe predictive view. Forecasts the next-30-day chargeback volume from current dispute pipeline.
Radar Score DistributionThe fraud-prevention lever. If fraudulent reasons dominate the open dispute mix, Radar tuning is the upstream fix.

Reconciling against the vendor’s own dashboard

Where to look in Stripe Dashboard: Payments → Disputes for the full per-dispute list with status, reason, deadline, and evidence-submission state. Filter to Status = Needs response for the formal chargebacks that match this card’s primary count. Filter to Status = Warning needs response for the early-warning subset. The Disputes overview view provides aggregate trend data; useful for the rate-and-trend cards but not for the live count. Why our number may legitimately differ from Stripe Dashboard:
ReasonDirectionWhy
Refresh lag. Vortex IQ refreshes the dispute list every 5 to 15 minutes; the Dashboard updates immediately.Vortex IQ slightly staleWait for next refresh; check last_synced_at.
Status interpretation. Vortex IQ groups needs_response and warning_needs_response; the Dashboard often shows them separately.Same total, different layoutCheck the per-status decomposition in this card’s metadata.
Page cap. Vortex IQ paginates at 1,000 disputes per refresh.Vortex IQ truncated for very high-volume merchantsMost merchants have <50 open disputes; the cap rarely matters.
Time-zone. Stripe Dashboard uses your account-level time zone; deadline calculations may differ by hours at boundary.Boundary-day differencesThe deadline in the card is the source-of-truth UTC timestamp.
Closed-but-not-yet-displayed. A dispute that just transitioned to won, lost, or under_review may briefly appear in both views during the sync window.Vortex IQ slightly higher for ~1 minuteSelf-resolves quickly.
Cross-connector reconciliation:
CardExpected relationshipWhat causes legitimate divergence
paypal.pp_disputes_openStripe and PayPal disputes are independent populationsA merchant using both processors sees disputes filed against each independently; sum the two for total exposure.
shopify.refund_rateInverse leading indicatorHigh-refund merchants typically have lower dispute rates because they refund pre-dispute; the trade-off is real cost (refund) vs avoided cost (chargeback fee + chargeback-rate impact).
shopify.fraud_rateLeading indicator at 30 to 60 day lagChargebacks file 30 to 90 days after the original transaction; a rising Shopify-side fraud-flag rate today predicts a Stripe-side dispute rise next month.
The most useful reconciliation rule: open disputes count + closed disputes (last 30 days) ÷ total successful charges (last 30 days) should be < 0.9% to stay below Visa’s threshold; < 1.5% for Mastercard. Above either, Stripe will start applying their own monitoring program (additional fees, mandated chargeback prevention requirements).

Known limitations / merchant FAQs

The card alerts at >0. That seems aggressive. Should I change it? The threshold is deliberately tight because every open dispute has a hard deadline. A missed deadline equals an automatic loss; the funds plus dispute fee are debited from your Stripe balance with no recourse. The right operational pattern is daily triage, not weekly. If your dispute volume is so high that the binary alert produces noise, the right fix is reducing dispute volume (Radar tuning, payment-method updates, fulfilment improvements), not raising the threshold. Should I always submit evidence, or refund pre-emptively? Depends on the dispute reason and value. (a) fraudulent: refund pre-emptively if early-warning, accept loss if formal chargeback unless evidence is unusually strong (e.g. delivered to verified billing address, customer email confirming receipt). Win rate <10% on fraudulent even with strong evidence. (b) product_not_received: fight if you have shipping carrier delivery confirmation; win rate 60 to 80%. (c) unrecognized or customer_initiated: fight if you have customer email correspondence or IP-address-at-purchase logs; win rate 40 to 60%. (d) duplicate: refund the duplicate immediately and submit evidence of the legitimate charge; win rate 70 to 85%. (e) subscription_canceled or subscription_disagreement: review the subscription cancellation flow; refund if the cancellation was attempted but the system kept charging. What is “early warning” / warning_needs_response? Visa Rapid Dispute Resolution (RDR) and Mastercom Collaboration are pre-chargeback notification services. The card network notifies the merchant before the formal chargeback files; the merchant has ~10 days to refund the customer pre-emptively. If refunded, no chargeback files. If not, the chargeback proceeds. Refunding pre-emptively is almost always cheaper than fighting the formal chargeback because: (a) you avoid the $15 dispute fee, (b) you avoid the chargeback-rate impact (which counts against your account threshold), (c) the customer gets the refund faster and is less likely to escalate further. My chargeback rate is approaching 0.9%. What happens at 0.9%? Visa’s Chargeback Monitoring Program (VCMP) and Mastercard’s Excessive Chargeback Program (MECP) flag merchants above 0.9% (Visa) / 1.5% (Mastercard) chargeback rate. Stripe is required to enrol you in their internal monitoring program at these thresholds; expect mandatory chargeback-prevention measures (3DS for high-risk transactions, additional Radar rules, reduced authorisation limits) and an additional ~$30/month per program. If the rate stays elevated for 4 to 12 consecutive months, your Stripe account can be terminated. The threshold is the prevention line; below 0.5% is healthy. A single high-value dispute could move my chargeback rate from 0.4% to 0.9%. Is that possible? Yes for low-volume merchants. Chargeback rate is chargebacks ÷ transactions; on a 200-transaction merchant a single chargeback is 0.5%. The threshold-management pattern: low-volume merchants need to fight every dispute aggressively because the rate impact is large; high-volume merchants can afford to refund-pre-emptively because the rate impact of any single dispute is small. Why is fraudulent reason so hard to win even with evidence? Card networks have a structural bias toward the cardholder for fraud claims because the alternative (forcing cardholders to prove they didn’t make the charge) is operationally impossible. The merchant must prove (a) the charge was authorised by the actual cardholder, AND (b) the goods / service was delivered to the cardholder. Strong evidence (signature on delivery, IP address matching billing address geographic region, customer-email confirming receipt) increases win rate but doesn’t typically exceed 30%. The right view: fight to deter, not to win; documented dispute defence reduces serial fraudster attacks even when the individual case loses. Stripe Radar already blocks fraud. Why am I getting fraud disputes? Radar’s job is to maximise legitimate-charge throughput while minimising fraud; it tunes to your merchant’s risk tolerance. Even at the most conservative setting, Radar lets through some fraud, the alternative would be blocking too many legitimate charges. The dispute card surfaces the fraud Radar didn’t catch; review it monthly with Radar Score Distribution to identify whether Radar tuning needs to shift toward stricter (raise the block threshold from “high” to “elevated”) at the cost of higher false-positive rate. What’s the average evidence-submission deadline? ~7 days for formal chargebacks (needs_response); ~10 days for early warnings (warning_needs_response). The exact deadline is in the dispute’s evidence_details.due_by field; the card surfaces days-remaining for triage. Never wait until day 6, evidence packs commonly need 30 to 60 minutes of work and any system issue (Stripe portal slowness, missing carrier data) can lose hours. Can I auto-submit evidence? Yes for the structured cases. Stripe’s Sigma platform and several third-party tools (Chargeflow, Disputifier, Sift) automate evidence assembly using shipping data, customer correspondence, and IP-address logs. ROI is positive on merchants with >$500 monthly disputed value; below that the manual cost is lower.

Tracked live in Vortex IQ Nerve Centre

Open Disputes is one of hundreds of KPI pulses Vortex IQ tracks across Stripe and 70+ other ecommerce connectors. Nerve Centre runs the detection layer; Vortex Mind investigates the cause when something moves; Ask Viq lets you interrogate any number in plain English. Start for free or book a demo to see this metric running on your own data.