← Technical articles

Practical developer checklist

WooCommerce checkout payment failed: a developer troubleshooting checklist

Diagnose WooCommerce checkout and payment failures safely: gateway callbacks, order status, plugin conflicts and staging tests.

Use these steps to narrow down the failure before changing production code. Work on staging when possible and remove sensitive information from logs or screenshots.

01

Identify the failing step

Record whether checkout rejects the form, redirects incorrectly, creates an unpaid order or receives payment without updating the order. Reproduce with a gateway sandbox account; never test using a customer's live card.

02

Inspect the gateway and webhook path

Check WooCommerce status logs and the payment provider's event delivery logs. Match gateway event IDs to order IDs. A successful payment with a pending order can indicate a delayed or rejected webhook rather than a card-processing failure.

03

Check configuration and conflicts

Verify gateway credentials belong to the intended environment, callback URLs are reachable over HTTPS, and caching excludes checkout and cart. Compare behavior with a default theme and nonessential extensions disabled on staging, not on a busy production store.

04

Verify before releasing

Test successful, declined, duplicate and interrupted payments. Confirm orders are not created twice, stock and emails update once, and refunds behave as expected. Preserve sanitized logs and a rollback plan.

Need implementation support?

Get the issue investigated and fixed

Share a sanitized error description, your environment and the expected result. No passwords or production credentials are needed for an initial enquiry.