Plugin Guides

TrustLens Chargeback Speedometer: How to Read the Ratios Before Your Gateway Does

TrustLens Chargeback Speedometer: How to Read the Ratios Before Your Gateway Does
🍷

Plugin Guide · TrustLens

Your Gateway Is Already Watching.

Card networks run silent monitoring programs against your chargeback ratio every month. TrustLens surfaces those thresholds on a dashboard speedometer so you can see where you stand โ€” and act โ€” before your processor does. This guide explains every threshold, every state, and every step that follows.

A chargeback ratio is not just a fraud metric. It is the number your payment processor and the card networks use to decide whether you are a merchant worth keeping. Cross a threshold and you enter a monitoring program. Stay in a monitoring program long enough and you face fines, rolling reserves, or account termination.

Most store owners only find out they have a ratio problem when the processor emails them. By that point the ratio has usually been elevated for at least one full calendar month, and the options are narrowing. TrustLens is designed to surface this signal before it reaches that stage โ€” specifically through the Chargeback Ratio Speedometer on the Command Center dashboard.

This guide covers every threshold the speedometer tracks, how the ratio is actually calculated, what the three speedometer states mean in practice, and what you should do at each stage. All threshold values and state logic in this post are verified against the TrustLens plugin code (version 1.2.5).


Part of the TrustLens chargeback cluster

This post covers the dashboard speedometer and per-brand thresholds. For how to build a dispute response once a chargeback has already been filed, see how the TrustLens Dispute Evidence Report works. For the broader question of how a single chargeback affects your gateway account, see WooCommerce chargebacks and gateway bans.

Why chargeback ratios matter more than chargeback counts

Card networks and payment processors do not care how many chargebacks you have in absolute terms. They care what percentage of your transactions end in a dispute. A store processing 100 orders a month with 2 chargebacks has a 2.0% ratio. A store processing 10,000 orders with 50 chargebacks has a 0.5% ratio. The second store has 25 times as many chargebacks in absolute terms and is still in good standing. The first store is already over every major threshold and heading toward program enrollment.

This is the counterintuitive reality of chargeback risk: growth is partially self-protective. As your order volume rises, the same number of disputes represents a smaller ratio. But it also means that a stagnant or shrinking store is more vulnerable to ratio spikes from a small cluster of bad actors.

Card networks monitor this ratio at the calendar month level, per card brand. A Visa chargeback counts against your Visa ratio, not your Mastercard ratio. Each network has its own threshold and its own monitoring program, with its own consequences for merchants who enroll.

The five monitoring programs TrustLens tracks

TrustLens tracks five card-network monitoring programs. The threshold values below are the exact values used in the plugin code.

Program Card brand Threshold What enrollment means
Visa VFMP Visa 0.65% Visa Fraud Monitoring Program โ€” fraud-specific disputes. Enrollment triggers enhanced monitoring and potential fines. The tighter of the two Visa thresholds.
Visa VDMP Visa 0.90% Visa Dispute Monitoring Program โ€” all disputes. Enrollment is at 0.90% with 100+ disputes/month; TrustLens uses the ratio component. Fines escalate monthly until you exit.
Amex Excessive Disputes Amex 1.00% Amex’s excessive dispute monitoring program. Enrollment can lead to enhanced monitoring and account review.
Discover Excessive Disputes Discover 1.00% Discover’s excessive dispute monitoring. Similar consequences to Amex โ€” Discover is a smaller share of most stores’ volume but still tracked separately.
Mastercard ECP Mastercard 1.50% Excessive Chargeback Program. Mastercard’s threshold is the highest of the five, but the consequences of enrollment include monthly fines that increase at each tier.

A few things worth noting about this table. First, Visa is shown as two programs (VDMP and VFMP) because that is the structure TrustLens uses internally โ€” these labels correspond to the pre-2025 Visa program names. Visa consolidated these into VAMP in 2025, but TrustLens (as of v1.2.5) tracks them separately. In practice, the VFMP threshold of 0.65% is the tighter signal: a store can be below 0.90% and still be over 0.65% if its dispute pattern skews toward fraud-coded reason codes. Either way, the plugin will surface the “Approaching threshold” state if you are within 3 disputes of either line.

Second, Amex and Discover share the same threshold (1.00%) but are tracked independently. If you process meaningful volume on both brands, you need both ratios in good standing.

Third, these are the ratio thresholds. Visa VDMP also has a minimum transaction-count qualifier in its public program rules (100+ disputes per month for the standard tier). TrustLens applies the ratio threshold as the early-warning signal regardless of absolute dispute count, which is the right call for smaller stores โ€” even if you never hit the absolute count qualifier, trending toward the ratio threshold is a warning worth heeding.


Thresholds change โ€” and Visa’s program structure changed in 2025

Visa replaced VDMP and VFMP with a consolidated program called VAMP (Visa Acquirer Monitoring Program) in 2025. TrustLens version 1.2.5 still uses the legacy VDMP and VFMP labels and thresholds (0.90% and 0.65% respectively). The underlying principle is the same โ€” Visa monitors your dispute ratio and escalates consequences if you cross the threshold โ€” but the program name and the exact tier structure have changed. Verify the current thresholds with your acquiring bank or processor. TrustLens’s early-warning function (alerting you before you cross a ratio milestone) remains valid regardless of the program label. Mastercard ECP, Amex, and Discover thresholds in TrustLens reflect the programs as publicly documented at the time of this writing (May 2026) โ€” your acquiring bank may also have its own internal thresholds that are lower than the network-published numbers.

How TrustLens calculates your ratio

TrustLens calculates your chargeback ratio as disputes divided by card-transaction orders within a time window. Specifically, it counts WooCommerce orders that have been tagged as card-brand transactions (captured automatically for Stripe and WooPayments, or via the manual entry form for other gateways), then counts how many of those orders have a dispute event recorded in the same window.

The formula is simple:

Chargeback ratio = disputes in window ÷ card-transaction orders in window

Orders with status completed, processing, or refunded are counted as card orders when the card-brand metadata is present. This is the denominator. The numerator is dispute events (specifically dispute_created events) recorded in the same window.

There are two windows:

  • Calendar month: from the first day of the current month through now. This is what drives the Free dashboard speedometer and what card networks actually use for monitoring programs.
  • Trailing 30 days: a rolling window from 30 days ago through now. This is available in Pro alongside the calendar-month view and is useful for spotting trends that cross a month boundary.

The Free speedometer uses the calendar-month window. This is intentional โ€” it matches how card networks compute their monitoring ratios, so the comparison is as accurate as possible.

What feeds the denominator

TrustLens tags orders with card-brand metadata at the point of payment for Stripe and WooPayments. For other gateways, you can record chargebacks manually via the order edit screen โ€” TrustLens captures the card brand when you do this, so the per-brand breakdown in Pro stays accurate even for non-integrated gateways.

Only orders tagged as card transactions (the _trustlens_card_tx meta is set to 1) contribute to the denominator. Cash orders, BACS transfers, and other non-card payment methods do not count, which keeps the ratio meaningful. A 1% chargeback rate on card transactions is very different from a 1% rate across all orders including bank transfers.

Per-brand vs. blended

The Free speedometer shows a blended ratio: all card orders in the denominator, all disputes in the numerator, regardless of brand. The per-brand breakdown โ€” separate ratios for Visa, Mastercard, Amex, and Discover โ€” is a Pro feature available on the dedicated Chargeback Monitor page.

For the Free speedometer, TrustLens uses a conservative approximation: it evaluates the blended ratio against each network threshold and surfaces the one you are closest to crossing. This means the speedometer reflects your most urgent risk signal even without a Pro subscription, but it cannot tell you which brand is driving it.


If you use Stripe or WooPayments

Card-brand data flows in automatically โ€” you do not need to configure anything for the speedometer to work. For other gateways, use the Record Manual Chargeback form on the WooCommerce order edit page. Each manual entry prompts you to select the card brand, which feeds into both the blended and per-brand ratios.

Reading the three speedometer states

The TrustLens Chargeback Ratio speedometer uses three human-readable states. These are the exact labels from the plugin code.

Healthy

Your blended calendar-month ratio is comfortably below the nearest monitoring threshold. The exact distance varies โ€” the speedometer does not show the gap in the Free tier โ€” but Healthy means you are not within 3 disputes of crossing any network line.

Healthy is the normal operating state for most stores most of the time. It does not require action, but it does reward routine maintenance: understanding which customers account for most of your disputes, and whether any behavioral pattern is drifting upward.

Approaching threshold

Your blended ratio is close enough to a threshold that 3 or fewer additional disputes would cross it. The exact phrasing from the plugin: “Approaching threshold” fires when disputes_to_hit > 0 && disputes_to_hit <= 3 โ€” meaning you are within 3 disputes of the nearest network monitoring line, but have not crossed it yet.

This is the state where action is most effective. The ratio has not crossed a threshold, which means no monitoring program enrollment has been triggered. You still have room to reduce your dispute exposure before the month closes.

The Pro Chargeback Monitor page shows the exact “N disputes of room” math and names the specific program you are approaching, which tells you whether it is a Visa VFMP issue, a Mastercard ECP issue, or something else. In Free, you see the state label but not the per-brand attribution.

Action needed

Your ratio has crossed at least one network monitoring threshold. The “Action needed” state in TrustLens corresponds to status === 'danger' in the underlying data โ€” meaning your current calendar-month blended ratio is at or above one of the five threshold values.

This does not automatically mean you have been enrolled in a monitoring program. Enrollment also depends on your absolute dispute count (Visa VDMP, for example, has both a ratio and a volume qualifier). But it does mean your ratio is in the zone where enrollment can happen, and it means your processor has almost certainly already flagged the month.


A note on the “no card orders yet” state

If you have just installed TrustLens or have not yet recorded any card-brand transactions, the speedometer shows “No card orders yet” rather than a ratio. This is correct behavior โ€” the ratio is undefined when the denominator is zero. Run Historical Sync (TrustLens → Dashboard → Run Historical Sync) to build transaction history from your existing WooCommerce orders. The speedometer will populate as soon as card-brand data is available.

What to do when the speedometer reads Healthy

Healthy is not a reason to stop paying attention. It is a reason to understand your baseline before something changes it.

The most useful thing you can do during a Healthy period is look at the customers behind your disputes. TrustLens tracks per-customer dispute counts in every trust profile. A store with a 0.3% blended ratio might have 80% of that ratio concentrated in five customers โ€” customers who have already been scored Risk or Critical and who you could block at checkout before they file another dispute.

A second useful habit is checking whether your dispute pattern correlates with any promotional activity. Stores that run heavy discount campaigns or first-order coupons often see dispute spikes in the weeks after โ€” customers who bought at a discount, received the goods, and then filed chargebacks anyway. If your ratio ticks up every time you run a major sale, that is a signal worth acting on before the next one. For context on how behavioral signals feed into the trust scoring that drives those early warnings, see how TrustLens scores a WooCommerce customer.

What to do when it reads Approaching threshold

Approaching threshold means you have a narrow window to prevent the month from ending over a monitoring line. The window is defined in disputes, not days: you are within 3 disputes of crossing. Whether that is two days of exposure or two weeks depends on your dispute frequency.

The first step is identifying who is filing disputes. Go to TrustLens → Customers, sort by total disputes descending, and look at the top rows. Are these customers still active? Are they in the Risk or Critical segment? If so, blocking them at checkout prevents further orders from becoming further disputes.

The second step is reviewing any open disputes in your payment processor. Disputes that are filed but not yet resolved may close in your favour โ€” if they do, they typically do not count against your final monthly ratio depending on how your processor reports them. Responding promptly to open disputes matters here. For a detailed guide to assembling dispute evidence, see the TrustLens Dispute Evidence Report guide.

The third step is operational: if you are running a promotion or coupon campaign, consider pausing it until the month closes. The dispute exposure from a discounted purchase is not worth the ratio risk when you are already 2โ€“3 disputes from a monitoring threshold.

  1. Identify the customers behind recent disputes

    TrustLens → Customers, sort by Total Disputes descending. Focus on customers who have filed in the current calendar month. Check their segment and whether they are still placing orders.

  2. Block high-risk customers at checkout

    Customers in the Risk or Critical segment with a dispute on record are worth blocking before they file another one. TrustLens checkout enforcement works on both Classic and Blocks checkout. Blocking does not remove a prior dispute, but it prevents another one from this customer this month.

  3. Respond to open disputes in your processor portal

    Active disputes that you win may close before month-end. Even if the timing is uncertain, submitting evidence is the right move. Use the TrustLens Dispute Evidence Report (Pro) for a print-ready behavioral summary, or compile evidence manually for smaller gateways.

  4. Pause active promotions if possible

    New orders placed this month can become this month’s disputes if the customer files within the calendar window. If you are 1โ€“2 disputes from a threshold and mid-campaign, evaluate whether the revenue is worth the ratio risk.

  5. Upgrade to Pro for the exact per-brand breakdown

    The Free speedometer shows you are approaching a threshold but does not say which brand is driving it. Pro’s Chargeback Monitor page names the specific program (Visa VFMP, Mastercard ECP, etc.) and shows exactly how many disputes separate you from it. This information changes what you do next โ€” a VFMP issue requires a different response than a Mastercard ECP issue.

What to do when it reads Action needed

Action needed means your blended ratio has crossed at least one network threshold for the current calendar month. At this point, some of the month-end risk may already be locked in โ€” you cannot un-file a dispute that happened on the 5th. But there are still things you can do to limit the damage and to prevent next month from following the same trajectory.

Immediate actions

Block every customer in your Risk and Critical segments who has placed an order this month. This prevents any in-flight orders from becoming in-flight disputes. TrustLens bulk actions (Customers → select segment → Bulk Block) let you do this across the entire segment in a few clicks. Understand the risk: some of these customers may be false positives, particularly newer ones who have not accumulated enough order history. Use your judgment, and remember that you can unblock anyone at any time.

Contact your payment processor proactively. Processors generally respond better to merchants who self-report and present a remediation plan than to merchants who appear unaware of their ratio until the processor raises it. Reaching out first โ€” with evidence that you are tracking the issue and taking action โ€” is almost always better than waiting for the outreach to come the other direction.

Review the dispute reasons. If the disputes are concentrated in a specific reason code (item not received, not as described, unauthorized), that tells you something about the root cause. Item-not-received disputes often point to shipping or delivery issues. Unauthorized disputes often point to card-testing residue โ€” customers whose payment details were compromised in an attack that ran through your checkout. Unauthorized disputes in particular are worth cross-referencing with TrustLens Card-Testing Defense logs to check whether there was an attack in the relevant period.

Next-month planning

Even if this month ends over a threshold, next month does not have to. The ratio resets on the first of the month. Your goal is to enter the new month with a cleaner customer base, better dispute-response coverage, and a clearer view of which orders are likely to generate disputes.

TrustLens Automation Rules (Pro) can do some of this work automatically: rules that hold orders from Risk-segment customers for manual review, or that fire a webhook to your support team when a dispute is recorded, reduce the reaction time from days to minutes. For an overview of how automation rules work in practice, see how TrustLens automation rules work.

The ratio resets โ€” the relationship does not

A calendar month that ends over threshold does not automatically result in monitoring program enrollment on its own โ€” most programs require sustained elevation over multiple months. But each elevated month is evidence that your processor accumulates. Hitting 1.2% in January and 0.4% in February still leaves you with a January on record. The most effective remediation is not just fixing this month โ€” it is permanently reducing the customer behaviors that generate disputes in the first place.

Free vs Pro: what the speedometer gives you at each tier

The Chargeback Ratio Speedometer on the Free dashboard gives you a blended calendar-month ratio, a colored status dot, and one of three human-readable state labels. This is the core signal, and it is available to every TrustLens user at no cost.

Feature Free Pro
Blended calendar-month ratio
Healthy / Approaching / Action needed status
Per-brand ratio breakdown (Visa / Mastercard / Amex / Discover)
Threshold progress bars (% of each network line)
Trailing-30-day window alongside calendar month
12-month trend chart (blended)
Daily email alert when any brand crosses the warn threshold
Customizable warn threshold (50โ€“100% of network line)
Recent disputes activity feed
Top-disputed customers with one-click Dispute Evidence Report
Auto-Block After N Lost Disputes

The most operationally significant Pro feature is the daily email alert. By default, TrustLens Pro sends an alert when any card brand reaches 70% of its network threshold (configurable from 50โ€“100%). This means you get notified before you reach the “Approaching threshold” state โ€” with enough lead time to act. The alert fires once per brand per calendar month, so there is no risk of being flooded with notifications during a bad stretch.

The second most useful Pro feature for ratio management is the per-brand breakdown. When the blended speedometer reads Approaching or Action needed, knowing whether it is your Visa ratio or your Mastercard ratio that is driving the issue changes your response entirely. Visa disputes are often friendly-fraud or item-not-received complaints that respond to proactive communication. Mastercard disputes can skew toward unauthorized and require a different set of remediation actions.

Frequently asked questions

Does a chargeback from a Visa card count against my Mastercard ratio?

No. TrustLens captures the card brand on each paid order and counts disputes only against the ratio for the matching brand. A Visa dispute increments your Visa dispute count and is compared against the Visa VDMP and VFMP thresholds. It does not affect your Mastercard ECP calculation.

Does TrustLens automatically block customers when Action needed fires?

No. The free version of TrustLens never auto-blocks. The “Action needed” state is a dashboard signal โ€” it tells you the threshold has been crossed and that you should act, but no blocking or enforcement happens automatically without your input. TrustLens Pro can optionally auto-block after N lost disputes (configurable in settings), but this is off by default and requires explicit configuration.

My ratio is at 0.00% but the speedometer shows “No card orders yet” โ€” why?

The speedometer requires card-brand metadata on your orders to function. If none of your recent orders have been tagged as card transactions, the denominator is zero and the ratio is undefined rather than zero. For Stripe and WooPayments stores, this metadata is captured automatically on new orders. For existing historical orders, run Historical Sync from TrustLens → Dashboard. The speedometer populates as soon as qualifying orders are present.

Can I see last month’s ratio?

On the Free dashboard, you see only the current calendar month. TrustLens Pro includes a 12-month trend chart on the Chargeback Monitor page that shows your blended ratio for each of the past twelve months. This is useful for identifying whether a current elevated ratio is a one-off event or part of a worsening trend.

What is the warn threshold in Pro and how does it interact with the speedometer states?

The warn threshold in TrustLens Pro (default 70%, adjustable from 50โ€“100%) is the trigger for daily email alerts. When any brand’s ratio reaches 70% of its network threshold, the alert fires. This is a separate signal from the speedometer states โ€” it is designed to give you an earlier heads-up than the “Approaching threshold” state, which fires when you are within 3 disputes of the line regardless of percentage. A store with high order volume might have a 70% ratio alert fire weeks before it enters “Approaching threshold” territory. A store with lower order volume might see the reverse. Both signals are worth watching.

Does TrustLens track Visa VDMP and Visa VFMP separately?

Yes, as of TrustLens version 1.2.5. TrustLens tracks both historical Visa monitoring programs as distinct thresholds: VDMP at 0.90% and VFMP at 0.65%. In the Free speedometer, both are evaluated against the blended ratio, and the one you are closest to is used to determine the speedometer state. In the Pro Chargeback Monitor, both appear as separate progress bars. Note that Visa consolidated VDMP and VFMP into a single program (VAMP) in 2025 โ€” TrustLens continues to use the legacy labels and thresholds in its current version, which still serves as a meaningful early-warning signal even if the program branding has changed.


Key takeaways

  • Card networks monitor your chargeback ratio per brand, per calendar month. TrustLens tracks five programs: Visa VFMP (0.65%), Visa VDMP (0.90%), Amex (1.00%), Discover (1.00%), and Mastercard ECP (1.50%).
  • The Free speedometer uses a blended ratio against the nearest threshold and shows one of three states: Healthy, Approaching threshold (within 3 disputes of a line), or Action needed (over a line). Per-brand breakdown is a Pro feature.
  • Ratio = disputes ÷ card-transaction orders in the calendar month. Only orders tagged as card transactions (Stripe, WooPayments auto-tagged; other gateways via manual entry) count in the denominator.
  • Approaching threshold is the most actionable state: you have not crossed a line yet, you have room to act, and the ratio has not triggered monitoring program enrollment.
  • Action needed calls for immediate response: block high-risk customers, contact your processor proactively, investigate dispute reason codes, and plan the month boundary reset.
  • TrustLens Pro adds per-brand ratios, a 12-month trend chart, trailing-30-day view, daily email alerts at a configurable warn threshold, and the Dispute Evidence Report โ€” the full toolkit for ratio management before and after a threshold is crossed.

Getting the most out of the speedometer

The Chargeback Ratio Speedometer is not a fire alarm. It is a pressure gauge โ€” one that gives you a reading before the pressure becomes a problem, if you check it regularly. The most effective use is routine: open the TrustLens dashboard at the start of each week, note the state, and spend five minutes on the customer list if it is anything other than Healthy.

Stores that manage their chargeback ratio well are not necessarily the ones with the lowest absolute dispute counts. They are the ones that understand the denominator as well as the numerator โ€” that a busy, high-volume month full of completed orders is a ratio-protective event, and that a slow month with even a handful of disputes is the moment to pay attention.

If you are not yet tracking dispute activity by customer, the TrustLens plugin page has the full feature overview and installation instructions. The speedometer, the customer trust profiles, and the chargeback tracking module are all included in the free version.

Webstepper

We build WooCommerce tools and write about the operational realities of running a store โ€” pricing, fraud, scheduling, and the decisions that compound over time.