How to Use TrustLens’s Dispute Evidence Report to Win a WooCommerce Chargeback
Plugin Guide · TrustLens Pro
One Click. One Report. One Chance.
When a chargeback arrives, you get one submission window. TrustLens Pro’s Dispute Evidence Report turns your customer’s full behavioral history into a print-ready document — designed to be attached to a Stripe or WooPayments dispute response on the day it lands.
The hardest part of a chargeback dispute is not knowing what to submit. Most store owners have the right instinct — they know behavioral history matters, that prior orders and refund patterns tell a story a tracking number cannot — but pulling that history together under a 7-to-21-day deadline is slow, manual work. By the time you have assembled it, you have often already missed the best submission window.
TrustLens Pro includes a feature built specifically for this moment: the Dispute Evidence Report. It is a Pro-only, one-click behavioral risk report accessible directly from the customer’s profile page or from the WooCommerce order metabox. The output is a print-optimized HTML document that you can save as a PDF and upload to a payment processor dispute portal alongside your other evidence.
This guide covers what the report contains (verified against the plugin code), how to generate it from both entry points, how to attach it to Stripe and WooPayments dispute submissions, and how to assess honestly whether the report will strengthen your case before you submit.
Part of the chargeback cluster
This post is the TrustLens-specific workflow layer. For the general evidence strategy — what four layers of evidence a dispute response needs, and why behavioral history is the layer most merchants skip — see How to Fight a WooCommerce Chargeback and Actually Win. For the upstream signals that typically precede a chargeback, see The WooCommerce Chargeback You Could Have Seen Coming. If you are not yet familiar with how chargebacks affect your payment processor relationship and account standing, WooCommerce Chargebacks: How a Few Disputes Can Trigger a Payment Gateway Ban covers the mechanics from the start.
What This Report Is For — and What It Is Not
The Dispute Evidence Report is a behavioral history document. It is not a tracking number, a delivery confirmation, or a product description — those are the transaction-documentation layer of a dispute package. This report is the behavioral layer: it tells the bank who this customer is on your store, what their history looks like, and whether their current dispute claim fits that pattern or contradicts it.
That distinction matters for how you use the report. A customer who has placed eight orders over two years and is disputing their most recent one produces a report that directly supports a Compelling Evidence argument: prior non-disputed transactions, an established purchasing relationship, a pattern that is inconsistent with “I don’t recognise this charge.” A first-time buyer with no prior history produces a report that shows exactly that — limited behavioral data — which tells you the report adds little to this particular dispute and you should focus on identity linkage and transaction documentation instead.
The Dispute Evidence Report does not fabricate evidence. It documents the behavioral history that TrustLens has tracked through its eight detection modules and the customer’s actual order history in your WooCommerce store. Good behavioral history strengthens a dispute. Thin behavioral history tells you something different: that this dispute is not a behavioral history fight, and you should adjust your strategy accordingly.
What the Dispute Evidence Report Actually Contains
The TrustLens Dispute Evidence Report is generated by the TrustLens_Dispute_Report class (Pro-only, requires the Chargebacks module to be active). It is a print-optimized HTML page that saves cleanly to PDF via the browser’s print dialog. The report is structured in six sections:
1. Report header
The header identifies the document as a “Customer Behavioral Risk Report” generated by TrustLens, shows your store name and URL, and includes the generation date and time. This framing is deliberate — it positions the document as a formal behavioral risk report rather than a manual note, which adds weight when submitted to a bank reviewer who processes dozens of dispute responses.
2. Risk summary
Three data points displayed prominently in a grid:
- Trust score: the customer’s current TrustLens score on a 0–100 scale
- Risk segment: their classification in the six-tier system — VIP, Trusted, Normal, Caution, Risk, or Critical
- Account age: calculated from their first order date, expressed as years, months, or days
Below the grid, the report lists every active risk signal currently contributing to the customer’s score — each signal labelled with a plain-English description and its point value (positive signals in green, negative in red). These signals come directly from TrustLens’s eight detection modules: return abuse, order patterns, coupon abuse, category-aware risk, linked accounts, shipping anomalies, chargebacks, and card-testing exposure.
3. Disputed order (conditional)
If you generate the report from the WooCommerce order edit page rather than from the customer profile, TrustLens includes a highlighted section at the top showing the specific disputed order: order number, date, total, status, payment method, shipping address, and a line-item breakdown. This section is skipped when you generate from the customer profile without a specific order context.
Including the disputed order context is useful when you want the reviewer to see the disputed transaction directly alongside the customer’s behavioral history — making the contrast explicit.
4. Order history
A table of up to 50 of the customer’s most recent orders, showing order number, date, total, status, and any refund amount on each order. This is the behavioral history layer that most directly supports a Compelling Evidence argument: prior completed orders, each with its date and status, showing that this customer has transacted with your store repeatedly without disputing.
For a customer with a long history, the reviewer sees a clear pattern. For a new customer with one or two orders, the table is short — but it is still accurate, and its brevity is itself informative.
5. Return analysis
A comparison of the customer’s return rate against your store-wide average, including:
- Customer return rate vs. store average return rate (percentage)
- Total refund count, broken down into full refunds and partial refunds
- Total refund value in currency
When the customer’s return rate significantly exceeds the store average, TrustLens adds an explicit callout — for example, “This customer’s return rate is 4.2x higher than the store average (38% vs 9%).” That phrasing is directly quotable in your summary statement to the bank, providing context that a shipping confirmation screenshot cannot.
6. Linked accounts (when present)
If TrustLens’s linked accounts detection module has identified other customer accounts sharing fingerprint data with this customer — same shipping address, billing address, phone number, IP address, payment method, or device — those linked accounts appear in this section. Each shows the linked account’s trust score, risk segment, blocked status (if applicable), and the specific match types that created the link.
Linked accounts are relevant in dispute responses involving suspected systematic fraud. If the disputing customer is part of a multi-account cluster that has previously received refunds or placed disputes across your store, that pattern is documented here.
7. Event timeline
A chronological log of up to 50 of the customer’s most recent events tracked by TrustLens, including completed orders, refunds (with amounts), order cancellations, customer block events, and dispute-related events. Each entry shows the event type, date, time, and the associated order number where applicable.
Negative events (refunds, cancellations, disputes, blocks) are visually marked in red. Positive events (completed orders) are marked in green. The timeline makes it possible to see, at a glance, the sequence of events leading up to a dispute — including whether the customer contacted your support team or simply filed with their bank after receiving goods.
Historical sync makes this meaningful from day one
TrustLens’s Historical Sync builds customer profiles from your existing WooCommerce order history — not just orders placed after installation. This means the order history, refund analysis, and event timeline in the report reflect your actual customer relationship, going back as far as your store data does. If you installed TrustLens last month, the report for a long-standing customer still contains their full prior history. The sync runs in the background in small batches and does not affect site performance.
How to Generate the Report: Two Entry Points
TrustLens Pro surfaces the Dispute Evidence Report from two places in your WordPress admin. Both produce the same report. The difference is context: one includes the specific disputed order, and one does not.
Entry point 1: TrustLens customer profile
Open TrustLens and find the customer
Go to TrustLens in your WordPress admin menu. On the customer list page, search by email address or customer name. Click through to the customer’s profile page. You will see their trust score, segment, signal breakdown, and behavioral history.
Click “Dispute Report”
In the action buttons on the customer profile page, TrustLens Pro adds a “Dispute Report” button. Clicking it opens the report in a new browser tab. The report opens immediately — there is no loading step or configuration prompt.
Save as PDF
At the top of the report page, a sticky toolbar shows the instruction: “Save as PDF: Click ‘Print Report’ below, then select ‘Save as PDF’ as your printer.” Click the “Print Report” button, select your PDF printer (on most systems this is “Save as PDF” or “Microsoft Print to PDF”), and save the file. The report’s print stylesheet hides the toolbar and renders cleanly for PDF output.
Entry point 2: WooCommerce order edit page
Open the disputed order in WooCommerce
Navigate to WooCommerce → Orders and open the order that has been disputed. TrustLens Pro adds a metabox to the order edit page showing the customer’s trust score and segment. Within that metabox, you will see a “Dispute Report →” link.
Click “Dispute Report →”
The link opens the report in a new tab, with the disputed order’s details automatically populated in the “Disputed Order” section at the top. This is the recommended entry point when you want the specific disputed order context included in the report, as it makes it easier for the bank reviewer to correlate the behavioral history with the specific transaction in question.
Save as PDF
Same procedure as above: use the “Print Report” button in the toolbar, select “Save as PDF,” and save the file. Name it clearly — something like “CustomerBehavioralRiskReport-[CustomerEmail]-[Date].pdf” — so it is identifiable when you upload it to the dispute portal.
Also accessible from the Chargeback Monitor
TrustLens Pro’s dedicated Chargeback Monitor page (TrustLens → Chargeback Monitor) shows a “top disputed customers” feed. Each customer in that feed includes a one-click link to their Dispute Evidence Report, making it easy to generate reports for multiple active disputes without navigating to each customer profile individually.
Reading the Report Before You Submit
Before attaching the report to a dispute, spend two minutes reading it. What you are looking for is whether the behavioral history it documents actually helps your case — because a report that shows a customer with no prior orders, no red flags, and no meaningful history does not strengthen your dispute. It just adds a document that tells the reviewer there is nothing unusual about this customer, which is not the argument you want to make.
Three things to assess:
Does the order history show prior non-disputed transactions?
This is the core of a Compelling Evidence argument. If the customer has two or more completed orders that predate the disputed one, and those orders were not disputed, that history is directly usable in your dispute summary. Note the number of prior orders, the total order value over time, and the dates — you will want to reference these in the summary statement you write for your processor.
Does the return analysis show elevated behavior?
If the customer’s return rate is materially higher than your store average, the report flags this explicitly with the multiplier (e.g. “3.8x higher than the store average”). That figure is quotable. It does not prove fraud, but it establishes that this customer’s behavior is statistically atypical relative to your customer base — relevant context for a bank reviewer assessing a friendly fraud claim.
Does the event timeline show a suspicious sequence?
A customer who received a shipping notification, received the goods (per your delivery confirmation), and then filed a dispute within days — without any contact with your support team — has a timeline that is inconsistent with genuine confusion about the charge. The event log in the report shows order completion, any refund events, and dispute-related events in sequence. If the pattern is there, it is visible without you having to construct it manually.
If the report shows a thin history, adjust your strategy
A report showing a first-time buyer with no red flags is honest — it means TrustLens does not have behavioral history to document. That is not a failure of the report; it is accurate information. For this dispute, focus on identity linkage evidence (matching email, IP, billing address, prior communication) and transaction documentation rather than behavioral history. Submitting a behavioral report that shows nothing unusual is not harmful, but it adds no persuasive weight. Save your effort for the layers that do.
Attaching the Report to a Stripe Dispute
Stripe’s dispute response interface is structured around the dispute reason code. When you open a dispute in the Stripe Dashboard under Payments → Disputes, you will see the reason code (e.g. “Unrecognized” for code 4853 or “General” for code 10.4), and a step-by-step evidence submission form that presents fields relevant to that code.
The Dispute Evidence Report maps onto Stripe’s evidence categories as follows:
| Report section | Stripe evidence field | Notes |
|---|---|---|
| Risk Summary (trust score, segment, signals) | Additional evidence (text) + file upload | Upload the PDF; reference the score and segment in your text summary |
| Order History (prior non-disputed orders) | Customer communication or uncategorized evidence | Upload the PDF and cite specific prior order numbers in your text summary |
| Return Analysis (elevated return rate vs. store average) | Additional evidence (text) | Quote the multiplier directly: “Customer’s return rate is 3.8x store average” |
| Linked Accounts (if present) | Additional evidence | Mention in your text summary; the PDF documents it visually |
| Event Timeline (sequence showing dispute vs. communication pattern) | Customer communication | Reference specific events in your text summary — e.g. “Customer received delivery notification on [date] and filed dispute [N] days later without contacting support” |
The evidence text field
Stripe gives you a text area for a summary statement — this is where the report pays off most directly. Write 4–6 sentences that walk the reviewer through the most persuasive points from the behavioral report alongside your transaction evidence. A structure that works:
- State the dispute reason code claim and what your transaction evidence shows directly contradicts it.
- State the number of prior non-disputed orders from this customer and the date range they span.
- If the return rate is elevated, quote the comparison: “Customer’s return rate of [X]% is [N]x the store average of [Y]%.”
- Note the timeline gap between delivery and dispute filing, and whether the customer contacted your support before filing.
- State that a full behavioral risk report is attached as an additional document.
File upload limits
Stripe accepts a combined total of 5MB across all evidence attachments, in PDF, JPG, or PNG format. The TrustLens Dispute Evidence Report saved as a PDF is typically well under 1MB. Leave room in the file budget for your shipping confirmation, order screenshot, and any customer communication records.
Attaching the Report to a WooPayments Dispute
WooPayments is built on Stripe’s infrastructure, so the underlying dispute mechanics — reason codes, evidence categories, response windows — are identical. The user interface for managing disputes appears in your WooCommerce admin rather than the Stripe Dashboard, but the submission process follows the same structure.
In WooCommerce, disputes for WooPayments-processed orders appear under Payments → Disputes. Click “Challenge” on an open dispute to access the evidence submission interface. The fields map to the same Stripe evidence categories described above. Save the TrustLens Dispute Evidence Report as a PDF and upload it in the additional evidence section, with a matching text summary referencing the behavioral history it documents.
Chargeback tracking is automatic for Stripe and WooPayments
If you use Stripe or WooPayments, TrustLens automatically ingests dispute events as they arrive — no manual setup required. Chargeback events appear in the customer’s event timeline immediately and feed into their trust score. This means the Dispute Evidence Report for a repeat disputing customer will include their dispute history as part of the event timeline, which is useful context for a bank reviewer assessing whether this specific dispute fits a pattern.
Other Processors: PayPal, Square, and Manual Gateways
The Dispute Evidence Report works for any processor — it is a PDF document, and any dispute portal that accepts file uploads can receive it. The mechanics differ by processor.
PayPal
PayPal’s Resolution Center allows merchants to upload evidence files and write a response statement when challenging a dispute. Navigate to Resolution Center → Activity → the disputed transaction → Respond, and submit your evidence package including the PDF. PayPal’s evidence form is less structured than Stripe’s — you will primarily be writing a summary and uploading supporting files, rather than filling categorised fields. Keep your summary concise and anchor it to the specific claim the buyer made.
Square
Square surfaces dispute challenges through its Dashboard under Disputes. Upload the PDF and write your summary statement in the response field. Square’s timelines are typically shorter than Stripe’s — some dispute types have a 7-day window from notification, so respond immediately when you receive the alert.
Manual gateways (PayPal Here, offline, custom)
TrustLens includes a manual chargeback entry form on the WooCommerce order edit page for gateways that do not automatically push dispute data into the system. If you have recorded manual chargebacks for a customer, those entries appear in the event timeline. This matters for the accuracy of the behavioral report: a customer who has previously disputed orders through a non-integrated gateway will have that history reflected in the report if you recorded those chargebacks manually.
When the Report Helps Most — and When It Does Not
The Dispute Evidence Report adds the most value in disputes where the behavioral history is substantive and the dispute claim is inconsistent with that history. Here is a realistic assessment of when it moves the needle and when it does not:
| Scenario | Report value | Why |
|---|---|---|
| Repeat customer, 5+ prior orders, no prior disputes, disputing their most recent order | High | Order history directly supports Compelling Evidence; prior non-disputed orders are the strongest behavioral signal |
| Customer with elevated return rate (significantly above store average), disputing instead of requesting a refund | High | Return rate comparison is concrete and quotable; establishes atypical behavioral pattern |
| Linked accounts detected — customer part of a multi-account cluster with prior dispute or refund history | High (for pattern) | Documents systematic behavior; linked account section of report is directly relevant evidence |
| Customer is in Caution, Risk, or Critical segment — multiple negative signals active | Moderate | Risk summary gives reviewer clear behavioral context; combined with transaction evidence this strengthens the package |
| First-time buyer, clean history, dispute on first order | Low | No meaningful behavioral history to document; focus on identity linkage and transaction evidence instead |
| Genuine customer service failure — item not delivered, wrong item shipped | None | Behavioral history is irrelevant when the dispute reflects a legitimate service problem; issue a refund rather than fighting |
The underlying logic is consistent with how banks assess friendly fraud disputes: they are looking for evidence that contradicts the stated claim. Behavioral history that shows a long-standing customer relationship, a pattern of completed orders, and a dispute that does not fit prior behavior is the most relevant evidence you can add to a transaction-documentation package. The report does not create that evidence — it documents it efficiently so you can submit it within your response window.
Frequently Asked Questions
Is the Dispute Evidence Report available in the free version of TrustLens?
No. The Dispute Evidence Report is a Pro-only feature. It requires TrustLens Pro to be licensed and the Chargebacks module to be active. The free version of TrustLens includes chargeback tracking (automatic ingestion from Stripe and WooPayments, plus manual entry for other gateways), per-customer dispute counters, and the Chargeback Ratio Speedometer on the dashboard — but the one-click report generation is Pro only.
Where exactly do I find the Dispute Report button?
Two places. First: the TrustLens customer profile page — after navigating to TrustLens and searching for the customer, the “Dispute Report” button appears in the action area of their profile. Second: the WooCommerce order edit page — TrustLens Pro adds a metabox to each order showing the customer’s trust score, and within that metabox there is a “Dispute Report →” link. Using the order page entry point includes the specific disputed order’s details in the report; using the customer profile entry point generates the behavioral history without a specific order section.
How do I save the report as a PDF?
The report opens in a new browser tab with a sticky toolbar containing a “Print Report” button. Click that button (or use your browser’s print function directly), then select “Save as PDF” as the printer. The report has a dedicated print stylesheet that hides the toolbar and renders the content cleanly for PDF output. Most modern browsers — Chrome, Edge, Firefox, Safari — support this natively without additional software. On Windows, “Microsoft Print to PDF” also works. Save the PDF with a descriptive filename before uploading it to your dispute portal.
What if TrustLens was installed recently — will the report have meaningful data?
Yes, if you have run the Historical Sync. TrustLens’s Historical Sync builds customer profiles from your existing WooCommerce order history — not just orders placed after installation. After running the sync (which runs in the background and does not affect site performance), TrustLens customer profiles reflect your store’s full historical data. A customer who has placed orders with your store for three years will have a three-year behavioral history in TrustLens after the sync completes, even if you installed the plugin last week.
Will submitting this report guarantee I win the dispute?
No. There are no guarantees in chargeback disputes — the process is tilted toward the cardholder by design. Industry estimates suggest merchants win around 20–30% of disputes they contest. The Dispute Evidence Report gives you the behavioral history layer that most merchants skip, which strengthens a dispute package when the history is substantive. But it works alongside transaction documentation (delivery proof, order confirmation, identity linkage) rather than replacing it. A complete evidence package with a strong behavioral history layer gives you the best realistic chance; it does not guarantee an outcome.
What is the difference between generating the report from the customer profile versus from the order page?
The behavioral content is identical — the same trust score, signals, order history, return analysis, linked accounts, and event timeline. The difference is whether the “Disputed Order” section appears at the top of the report. When you generate from the WooCommerce order edit page, TrustLens includes the specific order’s details (order number, date, total, status, payment method, shipping address, and line items) in a highlighted section at the top of the report. This makes it easier for a bank reviewer to correlate the behavioral history with the specific disputed transaction. For most dispute responses, the order page entry point is preferable for this reason.
Does TrustLens track chargeback history for customers who dispute through PayPal or other non-Stripe gateways?
TrustLens automatically tracks chargebacks for Stripe and WooPayments (which uses Stripe’s infrastructure). For other gateways — PayPal, Square, offline payment methods, or custom integrations — TrustLens provides a manual chargeback entry form on the WooCommerce order edit page. Manually recorded chargebacks appear in the customer’s event timeline and feed into their trust score, so if you record them consistently, the Dispute Evidence Report reflects a complete dispute history regardless of which gateway the original transaction used.
Key Takeaways
- TrustLens Pro’s Dispute Evidence Report is a print-ready behavioral risk document — accessible from the customer profile page or the WooCommerce order metabox — that compiles a customer’s full history into a single PDF for dispute submission.
- The report contains seven sections: report header, risk summary (trust score, segment, signals), disputed order details (when using the order page entry point), order history, return analysis vs. store average, linked accounts, and a chronological event timeline.
- Save the report as a PDF using your browser’s print-to-PDF function, then upload it to Stripe or WooPayments dispute portals alongside your transaction documentation and a concise text summary.
- The report’s value scales with the customer’s behavioral history. A customer with five prior non-disputed orders and an elevated return rate produces a report that directly supports a Compelling Evidence argument. A first-time buyer with clean history produces a report that honestly shows limited data — useful information, but not the basis for a behavioral dispute.
- Chargeback tracking is automatic for Stripe and WooPayments. For other gateways, use TrustLens’s manual chargeback entry form on the order edit page to keep dispute history accurate in customer profiles.
- The report does not create evidence that does not exist. It documents what TrustLens has tracked — efficiently, in a format designed for dispute submission, without manual assembly under deadline pressure.
The report does not decide the dispute — your preparation does
What the Dispute Evidence Report solves is an assembly problem. The behavioral history that makes the difference in a friendly fraud dispute — prior orders, refund patterns, linked accounts, event timeline — exists in your WooCommerce data. Extracting it, formatting it, and submitting it within a 7-day response window is where merchants typically fail, not because they lack the data but because they run out of time.
TrustLens Pro gives you that layer ready to go when the dispute notification arrives. You still need the transaction documentation — the order confirmation, delivery proof, identity linkage — and you still need to write a clear summary statement. But the behavioral layer, which is the most distinctive and persuasive evidence in a friendly fraud dispute, is one click away rather than an hour of manual work.
Use it for the cases where the history is substantive. Be honest with yourself when it is thin. And build the habit of running the historical sync early, so that when a dispute eventually lands — and for most stores, it will — the behavioral history is already there, accurate, and ready to submit.
If you want to explore the full TrustLens Pro feature set, the TrustLens plugin page covers the complete free and Pro feature breakdown. The free version includes all eight detection modules and chargeback tracking; Pro adds the Dispute Evidence Report, the Advanced Chargeback Monitor with per-brand ratio analytics, automation rules, and ten additional notification types.
