Modules Settings
2 min read
The Modules settings tab is where you enable, disable, and tune each of TrustLens’s eight detection modules. Each module has its own sub-section with module-specific settings. This page covers the structure of the tab and links to per-module detail.
Location: TrustLens → Settings → Modules.
The Module Toggles #
The Modules tab shows cards for the modules you toggle and tune here, using the same names that appear in the admin UI:
| Module (UI name) | Default | Disabling Cost |
|---|---|---|
| Return Abuse Detection | On | Lose the highest-signal module — almost never recommended |
| Order Tracking | On | Lose loyalty bonuses; abuse signals still work |
| Coupon Abuse Detection | On | OK to disable on stores without coupons |
| Category-Aware Scoring | On | OK to disable on single-category stores |
| Shipping Address Anomalies | On | OK on single-country / digital stores |
| Linked Accounts Detection | On | Lose strongest fraud-ring detection — rarely recommended |
Two of the eight detection modules behave a little differently on this tab:
- Card-Testing Defense appears here as a status card with a link to its own dedicated page (TrustLens → Card-Testing Defense), where you enable it and set its thresholds. It’s on by default; turn it off only if you have a separate WAF or gateway-level card-testing protection you trust completely.
- Chargeback Tracking is always on and is configured from the Chargebacks settings, not as a card on this tab.
Per-Module Settings Sub-Sections #
Each enabled module exposes its own settings panel. Click the module name to expand its panel.
Returns Module Settings #
- Critical return rate threshold (default 60%)
- High return rate threshold (default 40%)
Orders Module Settings #
No tunable settings — module is on/off only. Loyalty tiers and cancellation thresholds are hard-coded.
Coupons Module Settings #
- Max first-order coupons before flag (default 2)
- Block linked-account coupon abuse at checkout (default off)
Categories Module Settings #
- Category weights map (per-slug floats, default 1.0)
See Category-Aware Risk.
Linked Accounts Module Settings #
No tunable settings — fingerprint detection is fixed. Sensitivity is adjusted via the trust score signals indirectly.
Shipping Anomalies Module Settings #
- Velocity window (7–90 days, default 30)
- Address hopping threshold (default 3 addresses in window)
Chargebacks Module Settings #
- Warn threshold percent (default 70%, range 50–100%) — how close to a card network’s monitoring threshold the ratio status turns amber
- Auto-block after N lost disputes (Pro; default 2)
Card-Testing Module Settings #
Card-Testing Defense has its own dedicated page rather than living in the Modules tab — go to TrustLens → Card-Testing Defense to enable/disable it and tune its thresholds. The Modules tab shows it as the eighth detection module with a status badge and a link through to that page.
- 60-second decline threshold (default 3 declines per fingerprint)
- 60-second submission threshold (default 10 submissions per fingerprint)
- VIP customer bypass (default on) — exempts established customers (≥ minimum orders, not Risk/Critical)
- Panic Freeze duration (5, 15, or 30 minutes; 15 is the default, capped server-side at 30)
- Auto-escalation (Pro): fingerprint threshold (default 3), window (default 10 min)
- Geo-diversity safeguard (Pro): min countries (default 10), max single-country share (default 50%)
The 90-second fingerprint lockout is a fixed internal duration, not a configurable setting.
The Module Status Indicator #
Each module shows its current status next to the toggle:
- Green dot: Enabled and emitting signals
- Yellow dot: Enabled but no recent signals — module is on but quiet
- Gray dot: Disabled
If a module is enabled but persistently yellow, check whether the underlying behavior is happening at all — e.g. Chargebacks shows yellow if no disputes have been filed, which is healthy.
Bulk Recalculate After Settings Changes #
Changes to module settings don’t retroactively re-score customers. They take effect on the next recalculation per customer. To see the impact of a settings change immediately:
- Go to Customers list
- Select all (or filter to a relevant cohort)
- Bulk Recalculate
The recalculation runs in the background through Action Scheduler.
Restoring Module Defaults #
Each module’s settings sub-section has its own “Restore defaults” button that resets only that module’s settings. Useful when you’ve tuned one module too aggressively and want to undo without affecting other modules.
Per-Module Documentation #
For deep dives on each module:
