# OrderWarden documentation | WebKoding

How to install, licence and update OrderWarden. Find the orders your customers paid for that WooCommerce still calls Pending payment.

Source: https://webkodingtheme.com/docs/orderwarden/

---

# OrderWarden documentation

Find the orders your customers paid for that WooCommerce still calls Pending payment.
Back to OrderWarden — WooCommerce Order Stuck on Pending Payment? Fix It Open the demo

## Before you start

- •WordPress 6.5 or newer, WooCommerce 8.0 or newer, PHP 7.4 or newer
- •Your own Stripe, PayPal or Mollie account, connected through the official WooCommerce plugin for that gateway
- •API access: OrderWarden reuses the keys your gateway plugin already stores, or takes a separate read-only key (a Stripe restricted key with read access to PaymentIntents and Charges is enough)
- •Optional: a Slack, Discord or webhook URL of your own for alerts; email works out of the box
Runs on your own WordPress and asks your own Stripe, PayPal or Mollie account, with the keys your gateway plugin already holds. Nothing routes through us.

## What it does not do

- —It covers three gateways: WooCommerce Stripe Payment Gateway, WooCommerce PayPal Payments and Mollie Payments for WooCommerce. Other gateways need a developer and the ordw_providers filter.
- —It only reads from the gateways. It never captures, refunds or cancels a payment; a refund still happens in your gateway or in WooCommerce.
- —It cannot reconcile an order that never reached the gateway. Without the gateway’s payment id on the order there is nothing to ask about.
- —It cannot see webhook requests blocked before WordPress runs — by a firewall, a CDN or a wrong URL. Those show up as silence, which is what the quiet-webhook alert is for.

## What is in the download

One installable WordPress plugin ZIP: the reconciler, the mismatch inbox, the Health page and dashboard widget, the alert monitors and channels, and the audit log. Documentation as HTML. GPL code, HPOS-compatible.
It sends read-only requests to the payment providers you already use, only for orders paid with them and containing the provider’s own payment id. Alerts go only to the addresses and URLs you enter.

## Installing and setting up

Plugins → Add New → Upload Plugin, activate. WooCommerce must already be active. Then open WooCommerce → OrderWarden.
Settings: check that each gateway you use shows “API keys found”. If one does not, paste a read-only key. Choose the scan interval and the look-back window here too.
Alerts: set your email, Slack or Discord, or a webhook URL for Zapier, Make or n8n, and press “Send test alert”.
Press “Run a scan now” on the inbox, or wait for the first background scan.

## Demo mode

Demo mode answers seeded demo orders from bundled sample API responses, so you can see the inbox without gateway keys. Everything it produces is labelled “Demo data”. Leave it off on a live store.

## Licence, updates and support

- One licence covers 1 WordPress site.
- 1 year of updates, from the date of purchase.
- 1 year of email support.
- Instant download + licence key by email
- 30-day money-back guarantee
Questions this page does not answer go to support@webkoding.com . If you bought from us and cannot find your licence key, look it up here .

## Common questions

### Why is my WooCommerce order stuck on pending payment when the customer paid?

The gateway took the money but WooCommerce never heard about it. That news normally arrives by webhook, and if the webhook URL is wrong, the signing secret changed, a firewall or caching plugin blocks it, or the site was down at that moment, the order stays on Pending payment. OrderWarden asks the gateway directly and puts those orders in its inbox.

### What does Mark as paid do?

It asks the gateway again, and if the payment is still there, it calls WooCommerce’s own payment completion with the gateway’s transaction id. WooCommerce then updates the status, reduces stock and sends its usual emails, and an order note records the evidence and who clicked. Clicking twice does nothing the second time.

### Will it mark orders as paid on its own?

Only if you switch on auto-fix, which is off by default — and then only for Pending payment or Failed orders where the gateway captured exactly the order total, in the same currency, with no refund. Everything else waits for your click.

### What else does it catch besides unpaid orders?

An amount or currency that does not match the gateway; refunded at the gateway but still paid in WooCommerce; paid in WooCommerce but never captured at the gateway, which is an order not to ship; and authorised but not captured while the order is still unpaid.

### How does it know checkout has broken?

Three monitors. No new orders for a number of hours during your business hours, compared with your store’s own pace over the last 14 days, so a quiet store is not spammed. A spike in the share of failed orders. And a gateway whose orders keep coming in while its webhooks have stopped reaching your site.

### How often does it check?

Every 10, 15, 30 or 60 minutes, on Action Scheduler, which ships with WooCommerce. It looks back over a window you set, from 1 to 30 days, and can also check Processing and Completed orders for refunds and amount differences.

### Does it work with HPOS and the block checkout?

Yes, both. Orders are read and updated only through WooCommerce’s own order API.
