Never Miss a Dispute Deadline: A Walkthrough of TrustLens’s Chargeback Monitor

Dispute deadlines don’t announce themselves very loudly. A dispute arrives, your payment processor records it, and somewhere in the background a clock starts running. Stripe gives you 21 days to respond. PayPal gives you 10. Visa’s chargeback rules allow your acquirer’s own window on top of that. Miss it, and the decision is made for you: you lose the case by default, forfeit the funds, and pay the dispute fee anyway.

For a store with one or two open disputes at any time, this is manageable with a well-organized email inbox and a calendar reminder. For a store running volume — or for any store that’s gone through a rough patch with returns or a card-testing episode — keeping every deadline straight becomes genuinely hard. Cases pile up with different processors, different deadline dates, and different evidence requirements.

This post is a screen-by-screen walkthrough of the TrustLens Chargeback Monitor: what each section of the screen shows, what’s available in the free plan versus Pro, and how to use it practically so that no response window expires without a decision.

Why dispute deadlines slip — and what it costs

The most common reason a response deadline slips isn’t negligence — it’s that the notification arrived at a busy moment, got marked as “deal with later,” and then got buried. Payment processor emails don’t exactly scream urgency from the subject line. A notification that reads “Dispute received for order #4472” sits in an inbox that gets hundreds of emails a day.

The cost of missing a deadline is immediate and irreversible. The dispute closes as a loss, the funds are removed from your account, and the case is counted in your chargeback ratio for that card network and calendar month. If you’re already near a Visa or Mastercard monitoring threshold, even a small cluster of automatic losses can tip you into a program that takes months to exit.

Beyond the individual case, there’s a compounding effect. A missed deadline on a friendly-fraud dispute (a customer who genuinely received the order but filed anyway) means you’ve paid twice — once for the goods and once for the fee — and the customer learned that your store is a good target. That behavioral signal, by the way, shows up in the customer’s TrustLens trust score. But the score doesn’t help you if you’ve already lost the dispute by default.

The solution isn’t a better email filter. It’s a purpose-built view that keeps every open dispute and its deadline in one place, sorted by urgency. That’s what the TrustLens Chargeback Monitor’s Open Disputes worklist does.

What’s free vs. Pro in TrustLens chargeback tracking

TrustLens separates chargeback features across two tiers. It’s worth being precise about this before going further, because the free tier is genuinely useful and the Pro additions are specific — not just a vague “more features” promise.

In short: free tells you where you stand today. Pro tells you where you stand per card brand, what trend you’re on, and which disputes need your attention before their deadline expires.

If you’re on Stripe or WooPayments, the free tier requires no setup — disputes ingest automatically and card brand is captured on every paid order. For other gateways (PayPal, Square, manual/offline), you add disputes through the manual entry form on the order edit page.

The Chargeback Ratio Speedometer (free dashboard)

The TrustLens free dashboard includes a Chargeback Ratio Speedometer as part of its Command Center. The speedometer shows your blended calendar-month chargeback ratio — total disputes divided by total card orders for the current month — and classifies it as Healthy, Approaching threshold, or Action needed.

The classification uses the thresholds from the four major card networks’ monitoring programs as the benchmarks: Visa VDMP (0.9%), Visa VFMP (0.65%), Mastercard ECP (1.5%), Amex (1%), and Discover (1%). The speedometer applies these thresholds to your blended ratio, picking the one you’re closest to crossing and using that as the proximity signal. It doesn’t break out per-brand figures in the free tier — that’s a Pro feature — but it does give you a meaningful warning before a problem develops.

The dashboard speedometer also surfaces a “disputes to threshold” figure: how many additional disputes would push you over the nearest monitoring line. When that number falls to 3 or fewer, the status changes to “Approaching threshold” and the label text describes the specific program and remaining room. When you’ve already crossed a line, the label reads “Action needed” with the program name.

For most stores at normal dispute rates, the speedometer stays green and requires no attention. It’s when it starts shifting color that you know it’s time to open the full Chargeback Monitor.

The Chargeback Monitor page (Pro)

The TrustLens Chargeback Monitor is a dedicated admin page (TrustLens → Chargeback Monitor) available on Pro. It is built around a two-column layout that the plugin’s code describes as an “executive split” — the left column is focused on ratio metrics and trend, the right column is focused on recent activity.

The hero panel: calendar-month ratio and trailing 30 days

At the top of the left column sits the hero panel. It displays three figures side by side:

• Blended calendar-month ratio — your total dispute count divided by your total card orders for the current month, expressed as a percentage. This resets on the first of each month and is the number that card networks use when assessing monitoring program enrollment.
• Trailing-30-day ratio — a rolling window that doesn’t reset. This is useful for spotting a trend that developed partway through a month: if you had a bad week that started near a month boundary, the calendar-month view splits the damage across two months, making it look smaller. The trailing-30 view shows the full picture.
• All-time win rate — the percentage of settled (won + lost) disputes that you won. This gives you a rough sense of the quality of your dispute responses over time.

The hero panel’s headline status — Healthy, Approaching threshold, or Action needed — appears in the page header above it, with a plain-language subtext that says either how many disputes of room remain to the nearest line, or which specific program you’re over and what to do.

Per-brand network program progress bars

Below the hero panel, the left column shows a row of progress bars — one for each card-network monitoring program. The five programs tracked are:

• Visa VDMP (Visa Dispute Monitoring Program) — threshold: 0.9%
• Visa VFMP (Visa Fraud Monitoring Program) — threshold: 0.65%
• Mastercard ECP (Excessive Chargeback Program) — threshold: 1.5%
• Amex Excessive Disputes — threshold: 1.0%
• Discover Excessive Disputes — threshold: 1.0%

Each row shows the program name, a progress bar that fills proportionally to how much of the threshold you’ve consumed, the raw ratio percentage, and a status pill (OK / a percentage figure if approaching / “Over” if crossed). Rows with no data yet show a muted bar and a dash — this is normal for stores that don’t process a given brand at all, or that only recently installed TrustLens.

The “approaching threshold” warning fires at a configurable percentage of each threshold. The default is 70%, which you can adjust from 50% to 100% using the Alert Threshold slider on the same page. Setting it lower gives you more lead time; setting it at 100% means you only see a warning when you’ve actually crossed the line.

The 12-month trend chart

The left column also includes a 12-month trend chart showing your blended chargeback ratio month by month, oldest to newest. This is where the trailing-30 and calendar-month views connect to a longer arc. A single bad month is very different from a ratio that’s been gradually climbing for six months — the trend chart makes that distinction visible at a glance.

The chart data is cached for one hour (clearing automatically when a new dispute is recorded), so it won’t necessarily reflect a dispute recorded five minutes ago, but for month-level trend analysis the 1-hour cache is practically unnoticeable.

All-time outcomes panel

Below the trend chart, the left column shows an outcomes summary: total disputes, won, lost, pending, customers affected, and overall win rate. This is store-wide and all-time — it’s not filtered by the current month. It’s useful context for understanding your dispute program’s overall health, separate from the ratio question.

The recent activity feed

The right column of the Chargeback Monitor page shows a chronological activity feed of the 10 most recent dispute events — disputes opened and disputes closed — grouped by day. Each event shows the order number (linked to the order edit page), the amount, the customer email, the card brand, and the dispute reason code in plain language. Closed disputes are colored green (won) or red (lost) so the outcome is immediately visible without opening the order.

This feed is designed for operational awareness during an active dispute period. If three disputes arrived this week, you can see them all in one scroll, alongside any that closed.

Top disputed customers

The right column also includes a list of the top five customers by dispute count across all time. Each row shows the customer email, total dispute count, and a link to either their Dispute Evidence Report (if Pro) or their TrustLens customer profile. A red “Blocked” pill appears next to any customer who’s already been blocked at checkout.

This list is worth reviewing periodically rather than only when a dispute arrives. A customer with four disputes across 18 months is a very different risk profile than one with four disputes in the last 60 days — you can click through to the full customer profile to see the timeline. For more on how TrustLens scores and segments customers based on their dispute history and other behavioral signals, see how WooCommerce customer risk scoring works and how to read the signals.

The Open Disputes worklist and deadline countdown

The Open Disputes worklist is the feature added in TrustLens version 1.2.7. It lives on the Chargeback Monitor page, positioned prominently in the left column between the hero panel and the per-brand progress bars — because it represents the most operationally urgent information on the screen.

The worklist shows every dispute currently marked as open (not yet closed with a win or loss outcome), sorted by deadline. Disputes with a known response deadline appear first, sorted soonest to latest. Disputes without a deadline (common for manually entered disputes where the processor didn’t supply one, or for some gateway integrations) appear at the end of the list.

What the worklist shows for each dispute

Each row in the Open Disputes table includes:

• Deadline — a human-readable countdown label (more on this below) with a color-coded severity indicator
• Customer — the customer email address associated with the dispute, or a truncated hash if no email is on file
• Order — the order number, linked to the WooCommerce order edit page
• Amount — the disputed amount in your store’s currency
• Reason — the dispute reason code rendered in plain language (e.g. “Product not received” rather than a numeric code)
• Source — which gateway the dispute came from (Stripe, WooPayments, or manual)
• Actions — a button to open the Dispute Evidence Report for that customer and order (Pro feature)

The deadline countdown logic

The deadline column uses a color-coded countdown that TrustLens calculates against the dispute’s response due date in UTC. The severity bands, as implemented in the code, are:

• Overdue — deadline has already passed. Label: “Overdue by N day(s).” This dispute needs attention immediately if there’s any appeal path available.
• Urgent — deadline is within 2 days. Label: “Due today” or “Due in N day(s).”
• Soon — deadline is within 3 to 5 days. Label: “Due in N day(s).”
• Normal — deadline is 6 or more days away. Label: “Due in N day(s).”
• No deadline — no due date was supplied. Label: “No deadline.”

The sorting logic places disputes with deadlines before disputes without, and within the deadline group, sorts by soonest first. This means the dispute you most urgently need to act on is always at the top of the list — you don’t have to scan the whole table to find it.

If the worklist is empty, the table is replaced with the message “No open disputes — you’re all clear.” For stores that are actively working down their dispute backlog, seeing this message is a meaningful signal. For context on what a strong dispute response looks like once you open one of these cases, see the guide on building a WooCommerce dispute evidence package and rebuttal.

Due-soon alerts on the dashboard

The Open Disputes worklist lives on the Chargeback Monitor page — which means you only see it if you navigate there. TrustLens v1.2.7 added a second surface for deadline urgency: the dashboard alert band.

The dashboard alert band appears at the top of the TrustLens Command Center dashboard when any operationally critical condition is active. Three conditions can trigger an alert band entry:

1. A Panic Freeze is active (Card-Testing Defense, all checkouts blocked)
2. A targeted card-testing lockdown is in progress
3. Any chargeback network program ratio is over its threshold

Version 1.2.7 added a fourth: disputes due within 72 hours. The implementation counts open disputes whose due_by date falls within the next 72 hours and, if any exist, shows an alert with the count and a direct link to the Chargeback Monitor page.

The alert text reads: “[N] dispute(s) are due within 3 days. Respond before the deadline to keep your chance to win.” Clicking the “Review open disputes” button on the alert takes you directly to the Chargeback Monitor page where the worklist is sorted with those urgent cases at the top.

This is the most important practical difference the worklist adds. Without it, a dispute deadline could expire quietly while you were looking at other parts of the admin. With the dashboard alert, the first time you open WordPress admin and click on TrustLens, the due-soon count is front and center.

How to use the Chargeback Monitor day to day

Understanding the features is one thing. Using them in a way that actually reduces missed deadlines is another. Here’s how the monitoring flow works in practice for a store with an active dispute backlog.

One-click Dispute Evidence Report (Pro)

Every row in the Open Disputes worklist includes an “Evidence” button (if TrustLens Pro is active and the dispute is associated with a customer email hash). Clicking it opens a print-ready Dispute Evidence Report for that customer and order.

The Dispute Evidence Report pulls together the customer’s TrustLens profile into a single document formatted for submission alongside processor dispute responses. It includes the trust score and segment, all behavioral signals and their impact on the score, full order history, return rate analysis compared to the store average, linked accounts detected, and the complete event timeline. The same report is accessible from the top-disputed customers list on the Chargeback Monitor page, and from the customer profile page.

The report doesn’t replace the transaction-level evidence your processor requires (delivery confirmation, screenshots of the refund policy, shipping tracking). It complements it by giving you a behavioral risk portrait of the customer — the kind of context that a payment processor’s dispute team can factor in when reviewing your response. For a full breakdown of what goes into a strong dispute response package, see how to build a WooCommerce dispute response evidence package and rebuttal.

Keeping your chargeback ratio healthy long-term

The Chargeback Monitor is most useful as a diagnostic and operational tool, not just a reporting screen. The ratio figures it shows are downstream of decisions you make much earlier in the customer relationship: which customers you accept, how quickly you respond to issues, and how proactively you spot the behavioral patterns that precede disputes.

The customers who dispute most often are rarely random. They have behavioral histories: higher return rates, coupon-then-refund patterns, shipping address anomalies, or linked accounts already associated with previous disputes. TrustLens’s trust scoring engine picks up these patterns before a dispute arrives. The chargeback module applies a significant trust score penalty when a dispute is recorded, but the other detection modules often flag the same customer earlier — high return rate, repeat first-order coupon use, or account linking — which gives you time to apply a manual review before the order ships.

The practical habit that reduces ratio problems over time is reviewing your high-Risk and Critical customers regularly, not only reactively after a dispute arrives. For more on how the scoring engine surfaces these patterns and what to do about them, see how WooCommerce customer risk scoring works.

For stores on Stripe or WooPayments, dispute ingestion is automatic — TrustLens picks up the dispute event and updates the customer’s score without any manual step. For other gateways, the manual entry form on the order edit page keeps the data consistent. The general picture of how automatic chargeback tracking works in TrustLens for Stripe-based stores is covered in detail in how TrustLens tracks WooCommerce Stripe chargebacks automatically.

Key takeaways

Common questions

Is the Open Disputes worklist a free or Pro feature?

The Open Disputes worklist on the Chargeback Monitor page is a Pro feature. The free TrustLens dashboard includes the blended Chargeback Ratio Speedometer with Healthy / Approaching / Action-needed status, but the per-dispute deadline view requires Pro. Free users can see per-customer dispute counts on the customer profile, and disputes still feed into trust scores in the free tier.

Does TrustLens automatically ingest dispute deadlines from Stripe?

Yes. When a Stripe dispute is ingested, TrustLens captures the evidence_due_by timestamp from the dispute object and stores it as the deadline in the TrustLens disputes table. This is what the worklist’s countdown is calculated against. For WooPayments, the same field is captured. For manually entered disputes, the deadline is optional — you can supply it when you enter the dispute, or leave it blank.

How do I add a dispute from a gateway that isn’t Stripe or WooPayments?

Open the WooCommerce order associated with the disputed transaction and scroll to the TrustLens meta box on the order edit page. There’s a “Record Manual Chargeback” form where you can enter the dispute details — amount, reason, gateway, outcome (if already known), and due date. The dispute will appear in the Open Disputes worklist once saved, and the customer’s trust score will update to reflect the new dispute counter. TrustLens is fully compatible with WooCommerce HPOS, so manual entry works on both legacy post-based stores and HPOS-enabled stores.

What happens when a dispute is resolved?

When a dispute closes — either by you submitting a response and the network deciding, or automatically via Stripe’s webhook when a dispute is won or lost — TrustLens marks the dispute as closed with its outcome (won or lost) and removes it from the Open Disputes worklist. The outcome updates the customer’s disputes_won or disputes_lost counter, which affects their trust score. Won disputes apply a less severe impact than lost ones. Closed disputes continue to appear in the all-time outcomes panel and in the recent activity feed.

What does the chargeback ratio threshold email alert do exactly?

When TrustLens Pro is active, a daily background check runs against your calendar-month chargeback ratio for each card brand. If any brand crosses the configurable warning percentage of its network threshold (default: 70%), an email goes to the site admin email address. The alert is deduplicated: each brand sends at most one email per calendar month, regardless of how many times the daily check runs. This prevents repeated emails if you’re consistently above the warn line for a stretch of days. The email includes the brand name, current ratio, the threshold, and a direct link to the Chargeback Monitor page.

I just installed TrustLens. My Chargeback Monitor shows no data. Is that normal?

Yes. The Chargeback Monitor computes ratios from orders flagged as card transactions and from disputes recorded in the TrustLens disputes table. For Stripe and WooPayments orders, card-brand tagging happens at order placement going forward. For past orders, TrustLens includes a card brand backfill tool on the Chargeback Monitor page (at the bottom of the screen) that tags the card brand on your historical Stripe and WooPayments orders. Only orders processed after approximately 15 April 2026 are tagged automatically during Historical Sync; the backfill tool is for orders placed before that date. Once the backfill runs and some dispute data is present, the ratio figures populate. For a broader look at what TrustLens surfaces during the chargeback tracking process, see the complete WooCommerce chargebacks and disputes guide.

Webstepper

WooCommerce operator and plugin developer

We build TrustLens and Smart Cycle Discounts, and write about the operational realities of running a WooCommerce store — pricing strategy, fraud prevention, chargeback management, and the tradeoffs that don’t fit neatly into a tutorial.