Admin Configuration
This guide walks you through setting up the Fraud Prevention module for your shop.
Step 1 — Activate the Plugin
Tenant Admin → Plugins → Fraud Prevention → Activate
Step 2 — Open Fraud Settings
Tenant Admin → Fraud Prevention → Settings
Step 3 — Select Primary and Fallback Providers
Choose a Primary Provider and optionally a Fallback Provider from the grouped dropdown lists. Providers are grouped by region (Global, Bangladesh, India, Europe, Americas, Africa, Middle East) to help you choose the most relevant one for your customer base. Enter API credentials for your selected providers, set the auto-hold threshold, and save.
Pick the provider that matches your customers' region:
| Your Store Location | Recommended Primary Provider |
|---|---|
| Bangladesh | BDC courier or FraudDB |
| India | Bureau |
| Nigeria / Africa | Youverify or SmileID |
| UAE / MENA | Uqudo |
| USA / Latin America | Forter or ClearSale |
| Brazil | ClearSale |
| Europe | Ravelin |
| Global / Multi-region | IPQualityScore or SEON |
The primary provider runs first for every new order. The fallback runs only if the primary fails. Recommended fallback: IPQualityScore — works globally using IP analysis, requires only one API key.
Step 4 — Enter API Credentials
After selecting a provider, a credential form appears for that provider. Fill in the required fields (API key, secret, account ID, etc.). These come from your account on the provider's platform.
| Provider | Required Credentials |
|---|---|
| IPQualityScore | API Key |
| SEON | API Key |
| MaxMind | Account ID + License Key |
| Bureau | Client ID + Client Secret |
| FraudDB | API Key |
| Ravelin | API Key |
| SmileID | Partner ID + API Key |
| Youverify | API Key |
| Forter | Site ID + Secret Key |
| ClearSale | API Key |
| Uqudo | Client ID + Client Secret |
| BDC courier | API Key |
Only enter credentials for the providers you plan to use. The system only uses the active Primary and Fallback providers. Credentials are stored encrypted.
Leaving a credential field blank on save will not erase an existing saved key. Credentials are only updated when a non-empty value is submitted.
Step 5 — Set the Auto-Hold Threshold
The Auto-Hold Threshold determines at what risk score an order is automatically held for review.
| Threshold | Behavior |
|---|---|
| 0 | Every order is held (not recommended — too aggressive) |
| 50 | Orders with medium or higher risk are held |
| 80 | Only high-risk orders are held (default, recommended) |
| 100 | No orders are auto-held |
Tuning advice:
- Start with 80 and monitor results for 1–2 weeks
- If you are seeing many legitimate orders held: raise to 85–90
- If fraud slips through: lower to 70–75
- Orders with a risk score at or above the threshold are flagged as high-risk; orders below pass as safe
Step 6 — Save Settings
Click Save (or Save All Settings) after entering credentials and selecting providers. Settings apply immediately to all new orders — new orders will immediately start being assessed.
Quick Reference
| Task | Path |
|---|---|
| Activate plugin | Plugins → Fraud Prevention → Activate |
| Open settings | Fraud Prevention → Settings |
| Select primary provider | Settings → Primary Provider dropdown |
| Select fallback provider | Settings → Fallback Provider dropdown |
| Enter API credentials | Settings → credential fields per provider |
| Set auto-hold threshold | Settings → Threshold slider |
| View fraud result for an order | Orders → click any order → Fraud Analysis card |
| Review held orders | Orders → filter by status "On Hold" |
| Approve a held order | Orders → order detail → change status to Processing |
Next: Viewing Fraud Results to learn the held-order review flow.