Gatemi Shield Settings

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_… or rk_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).
Shopping Cart
Scroll to Top