Chargeback Settings
2 min read
The Chargebacks settings tab configures dispute-related behavior: gateway integration, warning thresholds, auto-block enforcement, and (Pro) the Chargeback Monitor page customization. This page walks through each setting.
Location: TrustLens → Settings → Chargebacks.
Ingestion Settings #
Auto-Ingestion Enabled #
Default: On
Master toggle for Stripe and WooPayments dispute webhook listeners. Disable only if you specifically want to ignore auto-ingestion and rely entirely on manual entry.
Stripe Webhook Status #
Read-only indicator showing whether dispute events are flowing in. Green if recent events received; yellow if not received in the configured period; red if errors detected.
WooPayments Webhook Status #
Same as Stripe but for WooPayments.
Ratio Threshold Settings #
Warn Threshold Percent #
Default: 70%
Percentage of brand monitoring threshold at which the speedometer turns yellow (and Pro daily alerts fire). Lower for earlier warning; higher for less alerting noise.
Per-Brand Thresholds (Pro) #
Override the default brand monitoring thresholds with your processor-specific values. Useful if your processor uses non-standard limits or if you want to track against a stricter internal threshold.
Auto-Block Settings (Pro) #
Auto-Block After N Lost Disputes #
Default: 2
If a customer accumulates this many lost disputes, automatically set is_blocked = true. Strong enforcement — combined with the master checkout-blocking toggle, prevents further orders.
Tune to 1: If you’re in active monitoring program territory and need maximum protection.
Tune to 3+: If you have high false-dispute rates and want patience before blocking.
Auto-Block After N Total Disputes #
Default: Off
Alternative trigger: block on total dispute count regardless of outcome. More aggressive than lost-only.
Alert Settings (Pro) #
Daily Ratio Email Alerts #
Default: On
Daily check that emails you when any brand’s ratio crosses the warn threshold. Deduplicated per brand per month. See Ratio Email Alerts.
Alert Recipients #
Comma-separated email list. Defaults to admin email.
Daily Check Time #
Time of day (store timezone) the daily check runs. Default 9 AM.
Suppress for Low Volume #
Default: On
If total monthly disputes are below the configured floor (default 5), don’t fire alerts — small stores can’t realistically hit monitoring program triggers.
Dispute Reason Categorization #
Recognized Reason Codes #
List of dispute reason codes TrustLens recognizes from Stripe/WooPayments and how they’re categorized internally. Auto-populated from gateway data.
Custom Reason Mapping #
Map custom or non-standard reason codes to TrustLens’s internal categories. Useful for stores with custom gateway integrations.
Display Settings #
Show Dispute Column on Orders List #
Default: On
Adds a dispute indicator to the WooCommerce orders list showing whether an order has been disputed.
Highlight Disputed Orders #
Default: On
Visually emphasizes disputed orders in the orders list (red border or icon).
Dispute Evidence Report Settings (Pro) #
Include Linked Accounts in Report #
Default: On
If on, the Dispute Evidence Report includes the customer’s linked accounts and their segments.
Include Event Timeline #
Default: On (full)
Options: Full / Recent 30 days / Recent 90 days / Off.
Custom Store Information #
Override the default store name, address, and contact info shown in the report header. Useful for white-labeling or for matching the legal entity name on your processor account.
Manual Entry Settings #
Require Reason on Manual Entry #
Default: Off
If on, the manual dispute entry form requires the Reason field to be filled. Improves data quality at the cost of speed.
Allow Orphan Disputes #
Default: On
If on, manual entry can create disputes without a linked WooCommerce order (useful for old orders that have been deleted).
Retention Settings #
Dispute Record Retention #
Default: Indefinite
How long to keep dispute records. Default keeps them forever. Can be configured to purge old records, but this is rarely needed and removes audit trail.
Testing #
Send Test Alert #
Button to send a test ratio alert email to verify configuration. Helpful when first setting up.
Simulate Webhook #
(Developer feature) Inject a fake dispute event to test downstream automation. Visible only in WP_DEBUG mode.
