Guide

WooCommerce Payment Troubleshooting Guide

Diagnose WooCommerce failed payments, pending orders, customer charge disputes, webhook delivery, gateway configuration, and provider-state mismatches.

Problem

Payment incidents require evidence from WooCommerce order notes, gateway logs, provider dashboards, webhook delivery, and customer communication.

For: WooCommerce operators, developers, and agencies responsible for payment reliability.

Workflow

What to review

Map The Payment State

Distinguish failed, pending, authorized, captured, refunded, voided, and abandoned payment states before changing an order.

Check Webhooks

Verify endpoint URLs, SSL, redirects, provider delivery status, and order-note updates so provider state reaches WooCommerce.

Recover Carefully

Ask customers to retry only after confirming whether funds were captured, authorized, declined, or voided.