The settings are at the bottom of WooCommerce → Gatemi Shield (capability manage_woocommerce). They are saved together in the option gatemi_shield_settings through WordPress's Settings API, so the screen's Save Changes button posts to options.php.
Whole-number settings cannot go below 1. Percentage settings cannot go below 0.
Card-testing guard
| Label | Key | Default | What it does |
|---|---|---|---|
| Block card-testing attacks | guard_enabled |
Enabled | Refuses checkout to a blocked IP address on the classic checkout, the Checkout block and the order-pay page. Failed payments are counted whether or not this is on. |
| Block an IP after this many failed payments | guard_max_failures |
5 | How many failed payments from one IP trigger a block. |
| …within (minutes) | guard_window_minutes |
60 | The window those failures are counted in. |
| Block for (minutes) | guard_block_minutes |
60 | How long the block lasts. |
| Attack alert: store-wide failed payments per hour | store_failure_spike |
15 | When this many orders fail across the whole store within an hour, you get one "Possible card-testing attack" email (at most one per hour). |
With the defaults: an IP address that produces 5 failed orders within an hour cannot check out for the next hour.
Logged-in users who can manage WooCommerce are never blocked.
Early-warning thresholds
Each rate has a warning and a danger level. A rate at or above the level takes that grade. The store's overall level is the worst of the three, and you are emailed when it gets worse — not every hour it stays the same.
| Label | Key | Default |
|---|---|---|
| Dispute rate warning (%) | warn_dispute_rate |
0.65 |
| Dispute rate danger (%) | danger_dispute_rate |
0.9 |
| Refund rate warning (%) | warn_refund_rate |
8.0 |
| Refund rate danger (%) | danger_refund_rate |
15.0 |
| Failed payment warning (%) | warn_failure_rate |
20.0 |
| Failed payment danger (%) | danger_failure_rate |
40.0 |
What each rate measures:
- Dispute rate — orders counted as disputed in the last 30 days, as a percentage of paid orders created in the last 30 days.
- Refund rate — refunds created in the last 30 days (each refund counts, including partial ones), as a percentage of those paid orders.
- Failed payment rate — failed orders in the last 24 hours, as a percentage of failed plus paid orders in the same 24 hours.
"Paid" means the statuses Processing, Completed, On hold and Refunded.
The dispute defaults sit below 0.9% because card-network monitoring programmes start around that level; the plugin warns you earlier. Your own processor's limits may be different — set the thresholds to match.
Minimum sample. A rate is graded Healthy until there is enough data: 20 paid orders in 30 days for disputes and refunds, 10 checkout attempts in 24 hours for failures. One dispute in five orders is noise. A developer can change the minimum with the gatemi_shield_min_sample filter.
Evidence
| Label | Key | Default | What it does |
|---|---|---|---|
| Record dispute evidence on every order | evidence_enabled |
Enabled | Seals a snapshot of how each new order was placed. See How it works. |
Turning it off stops new snapshots. Existing ones stay on their orders and the Dispute Evidence panel and packet download keep working for them.
Stripe
| Label | Key | Default | What it does |
|---|---|---|---|
| Sync disputes from Stripe | stripe_sync |
Enabled | Pulls disputes from Stripe every hour when a key is available. |
| Stripe key (optional) | stripe_secret_key |
empty | Your own Stripe key. Empty means: reuse the WooCommerce Stripe Gateway plugin's key. |
About the key field:
- It accepts a secret key or a restricted key:
sk_live_…,sk_test_…,rk_live_…orrk_test_…. A restricted key with Disputes: Write and Charges: Read is enough, and safest. - The saved key is never shown. The field displays
••••and the last four characters as a placeholder. - Leaving the field blank keeps the saved key. Typing something that is not a Stripe key also keeps the saved key.
- To remove a saved key, tick Remove saved key and save. The plugin then falls back to the WooCommerce Stripe Gateway key, if there is one.
- A
…_live_…key works in live mode, a…_test_…key in test mode. The Stripe disputes box says which is in use.
The fallback reads the option woocommerce_stripe_settings from the WooCommerce Stripe Gateway plugin — its test secret key when that plugin is in test mode, otherwise its live key. Keys stored by other Stripe plugins are not read; paste a key here instead.
Alerts
| Label | Key | Default |
|---|---|---|
| Send alerts to | alert_email |
The site's admin email at activation |
Where the risk-level, attack and new-dispute emails go. An invalid address is replaced with the default.
Buttons that are not settings
- Check now — runs the risk scan immediately.
- Sync disputes now — shown when Stripe is connected; syncs, then runs the scan.
- On an order's Dispute Evidence panel: Download evidence packet.
- On an order's Stripe Dispute panel, while the dispute needs a response: Send evidence to Stripe.
- In an order's Order actions menu: Gatemi Shield: mark as disputed (chargeback).
