PayInspector — Payment Diagnostics for WooCommerce

A declined payment often leaves you with an unclear error message. PayInspector translates available gateway and processor evidence into useful explanations directly inside your WooCommerce orders. See what happened, review the checks your gateway provided, and choose an informed next step. When the evidence is incomplete, PayInspector says so.

• Understand declined payments with plain-language explanations and suggested next steps.
• See billing street and ZIP/postal verification when provided by the payment gateway/processor.
• See CVC/CVV verification results when provided by the payment gateway/processor.
• Review payment-attempt history, including failed attempts and successful retries.
• View a store-wide payment health overview, separated by currency and payment environment.
• Support major Stripe and PayPal WooCommerce gateways through four included integrations.
• Keep diagnostics in local storage, with configurable retention and no telemetry.

PayInspector does not process payments or change payment decisions. It does not detect fraud, prevent chargebacks, guarantee a decline reason, recover revenue or promise more approvals. Supported gateways All four integrations are included in Free:

• Payment Plugins for Stripe WooCommerce: tested 4.0.13; compatible range >=4.0.13,<4.1.
• Payment Plugins for PayPal WooCommerce: tested 2.0.26; compatible range >=2.0.26,<2.1.
• WooCommerce Stripe Payment Gateway: tested 10.9.1; compatible range >=10.9.1,<10.10.
• WooCommerce PayPal Payments: tested 4.1.2; compatible range >=4.1.2,<4.2.

The supported scope is ordinary new card payments with immediate full capture, native Classic checkout, Checkout Blocks, order-pay and same-order retries, single-site WooCommerce, HPOS and legacy storage. Normal synchronous and asynchronous completion is included where the gateway exposes a linked response. Qualification used WordPress 7.1, WooCommerce 11.1.0 and PHP 8.4.24. WooCommerce 10.8 is the minimum runtime guard; it is not a claim that every intervening combination was tested. Later compatible patches are not individually qualified; verify upgrades on staging. Activate only one gateway plugin per processor. Competing official and Payment Plugins integrations can alter order gateway identities; PayInspector pauses affected recording when it detects this conflict. Out-of-range gateway versions also pause recording without disabling your gateway. Wallets, saved payment methods, alternate payment methods, WooCommerce Subscriptions, multisite, custom checkout replacements, disputes and advanced authorization/capture/refund reporting are outside this release's supported scope. Detailed 3DS diagnostics are conditional and may be unavailable. Read evidence with confidence Confirmed means explicit processor evidence supports the reason. Likely means supporting checks suggest a cause. Possible means evidence is limited or contradictory. Unavailable means there is not enough detail. An approved payment stays approved even if its address or security-code check disagrees. Risk signals are not proof of fraud; seller protection is an eligibility status, not a coverage guarantee. Privacy and storage Diagnostic records contain payment outcomes, amounts, currency, timestamps, gateway versions, transaction references, and verification results linked to local orders. No card number, actual CVC/CVV, payment credential or customer contact detail is copied into diagnostic records. Optional raw diagnostics contain only allowlisted, sanitized fields. Unknown fields and unrecognized free text are discarded. Raw metadata and debug logging are off by default. Retention defaults to 90 days. Expired records are hidden immediately and deleted by scheduled cleanup; cron must run for deletion to complete. WooCommerce order deletion and approved order personal-data erasure remove linked diagnostics. The WordPress personal-data exporter includes matching diagnostic evidence without payment references or amounts. Backups and downloaded reports require their own retention policies. PayInspector makes no remote processor lookups and sends no telemetry. Your separately installed payment gateway still communicates with its provider to process payments. WordPress itself may contact WordPress.org for normal plugin updates. Diagnostics do not import earlier transactions or responses that never reached this store. Help and safe reports Open WooCommerce → PayInspector → System Status & Help for definitions, supported scope, privacy guidance and a copyable system report. Order panels provide Export Diagnostic Report. Reports are allowlisted and exclude customer/order/payment identifiers, amounts, arbitrary text, raw metadata and credentials; the order report contains up to 100 recent retained attempts and indicates truncation. Review reports before sharing. Public support forums are visible to everyone. Operational limits Diagnostics fail open when storage is unavailable so they do not intentionally interrupt payment processing. Official gateways own their webhook acknowledgments; a diagnostic-only write failure may leave missing evidence unless another valid observation or provider resend arrives after recovery. Actual PayPal repeat delivery was not observed during sandbox qualification, although verified delivery and independent duplicate handling were tested. The overview counts attempts rather than unique orders; captured volume is not settled revenue or a recoverable-revenue estimate. PayInspector is an independent extension. WooCommerce® and its associated designs are trademarks of Automattic Inc. Stripe and PayPal names identify compatible third-party integrations; no affiliation or endorsement is implied.

1. Back up your site and test on staging. Install WooCommerce and one supported gateway plugin per processor.
2. Install PayInspector — Payment Diagnostics for WooCommerce in Plugins → Add Plugin, then activate it.
3. Open WooCommerce → PayInspector → Settings & gateways and verify recording status and gateway compatibility.
4. Run a sandbox success, decline and retry for the payment flows you use. Review the order panel and payment history before live rollout.

For earlier manually installed builds using the payment-intelligence or payment-intelligence-for-woocommerce folder, this package uses a different directory slug. Back up, deactivate the old copy, remove its plugin files with default data retention (do not enable permanent deletion), then install the new package and activate. Do not keep both copies installed. This is a manual package migration, not an automatic directory update.

0.1.0

• Initial Free release as PayInspector, with gateway diagnostics, local reports, scoped operational notices and documented external services.