Managing the blocklist

The blocklist stores atoms (emails, IPs, device fingerprints, phones, card BIN+last4, usernames) that should always score high. The Blocklist rule fires the moment any atom on the current order matches.

Adding an entry

1. Go to WooFraudGuard → Blocklist.
2. Click Add entry.
3. Pick a type, enter the value, and (optionally) a reason and duration.

Duration Permanent (0) means the entry never expires. Anything else expires automatically — handy for soft blocks while you investigate.

Auto-blocklist from chargebacks

When a Stripe or PayPal chargeback webhook arrives, WooFraudGuard can automatically add the disputed order\’s atoms to the blocklist. Configure which atom types under Settings → Privacy & API keys → Chargeback auto-blocklist. Email and device are enabled by default; IP/phone/BIN are off because they have higher false-positive rates.

Bulk operations

The table supports server-side search across value, source, and reason. For larger lists (1000+ entries), use the REST API — GET /wp-json/woofraudguard/v1/blocklist?per_page=100&page=2 — to page through programmatically.

Limits by license tier

Tier	Max entries
Lite (no license)	100
Business	10,000
Enterprise	Unlimited