Getting Started with Gatemi Shield

Payment processors put reserves on stores, or freeze them, when disputes, refunds or failed payments climb too high. Most shop owners find out when the money is already held. Gatemi Shield watches those numbers, blocks the bots that push them up, and keeps the evidence you need to answer a dispute.

It does four things:

  1. Card-testing guard — counts failed payments per IP address and refuses checkout to an address that keeps failing, before the attempt reaches your payment gateway.
  2. Early warning — every hour, grades your dispute rate, refund rate and failed-payment rate, and emails you when the store moves into Warning or Danger.
  3. Dispute evidence — records a sealed snapshot of how every order was placed, including orders placed by AI shopping agents, and builds a downloadable evidence packet.
  4. Stripe dispute sync — optional: pulls your Stripe disputes in every hour, links them to orders, emails you the deadline, and can copy your evidence into the Stripe dispute as a draft.

It is a free plugin with no paid edition.

Requirements

  • WordPress 6.4 or later
  • PHP 7.4 or later
  • WooCommerce 8.5 or later
  • Declared compatible with High-Performance Order Storage (and tested on both HPOS and the older posts storage) and with the Cart and Checkout blocks
  • WordPress cron running — the risk scan and the Stripe sync are hourly scheduled events
  • Your site able to send email (wp_mail()) for the alerts

The guard, the early warning and the evidence recorder work with any payment gateway. The dispute sync is for Stripe only.

1. Install

Gatemi Shield is coming to wordpress.org. Until it is listed:

  1. Download the plugin zip.
  2. Go to Plugins → Add New Plugin → Upload Plugin, choose the zip and press Install Now.
  3. Press Activate.

Activating saves the default settings and schedules the hourly scan (gatemi_shield_hourly_scan). Protection starts straight away with safe defaults; you do not have to configure anything.

2. Open the dashboard

Go to WooCommerce → Gatemi Shield (or Dashboard under the plugin on the Plugins screen). You need manage_woocommerce.

The page shows, from the top:

  • Payment account risk — Healthy, Warning or Danger — act now, when it was last checked, and a Check now button.
  • A table of what processors watch: disputes and refunds over 30 days, failed payments over 24 hours — your rate, the raw counts, the warning threshold and the status of each.
  • Stripe disputes — whether dispute sync is connected.
  • Recent activity — the last 20 events: blocked IPs, refused checkouts, disputes, alerts.
  • Settings.

On a small store the rates may all read Healthy even with a dispute or two. That is deliberate: a rate is not graded until there are enough orders for it to mean anything (20 paid orders for disputes and refunds, 10 checkout attempts for failures).

3. Check where alerts go

In Settings, Send alerts to defaults to your site's admin email. Change it to the address that should hear about attacks and disputes, and press Save Changes.

4. Connect Stripe (optional)

If you take payments with Stripe:

  • Using the WooCommerce Stripe Gateway plugin? Do nothing. Gatemi Shield reuses that plugin's secret key (its test key while the gateway is in test mode). The Stripe disputes box says Connected using the WooCommerce Stripe Gateway key.
  • Otherwise, or if you prefer a separate key:
    1. In the Stripe Dashboard, go to Developers → API keys and create a restricted key with Disputes: Write and Charges: Read.
    2. Paste it (rk_live_…, or rk_test_… for test mode) into Stripe key (optional) and save. A secret key (sk_…) also works, but a restricted key can do less if it ever leaks.

Within the hour, or immediately with Sync disputes now, the plugin looks back 120 days for disputes and links each to its order.

Stripe sync needs no webhook: the plugin asks Stripe's API every hour.

See How it works for what is sent to Stripe.

5. Check it works

  • Evidence: place a test order, then open it in WooCommerce → Orders. The sidebar shows Dispute Evidence (Gatemi Shield) with Placed by: Person (browser), the time recorded, Seal: intact ✓ and a Download evidence packet button.
  • Early warning: press Check now on the dashboard; Last checked updates.
  • Guard: not something to test on a live store. The settings show the limits: by default an IP is blocked for 60 minutes after 5 failed payments in 60 minutes.

Logged-in shop managers and administrators are never blocked, so testing the guard while signed in will not lock you out.

Next steps

Shopping Cart
Scroll to Top