Error fix
How to fix “WooCommerce payment gateway error”
Checkout failed at the PSP—credentials, webhooks, or currency mismatch.
Updated Apr 20, 2026
Tools that help with this
Fastest fix
Start here first. Step 1 fixes most cases—then work down the list.
- Reproduce with the smallest URL/command and capture full stderr or response body.
- Confirm versions (runtime, CLI, framework) against official requirements.
- Compare with CI or a second machine to rule out local-only issues.
What this means
Checkout failed at the PSP—credentials, webhooks, or currency mismatch. Use the steps below as a practical checklist—adapt commands to your OS and stack.
Common causes
Environment mismatch
Different Node/OS versions, missing env vars, or drift between local and deployed configs.
Bad inputs or timing
Race conditions, partial deploys, or hitting endpoints before dependencies are ready.
Step-by-step fix
Isolate and verify
- Reproduce with the smallest URL/command and capture full stderr or response body.
- Confirm versions (runtime, CLI, framework) against official requirements.
- Compare with CI or a second machine to rule out local-only issues.
Related
FAQ
- Is this tailored to my exact stack?
- These pages are structured guides. Swap in your package manager, paths, and hosting dashboard names.
- What should I paste into support?
- Full error text, timestamps, versions, and whether it reproduces in a clean profile or container.
- Can I share this page?
- Yes—each fix has a stable URL. Use “Copy fix link” on the page for teammates.
Fix related issues
Still stuck? Try these related fixes next.
- WordPress critical errorPHP fatals before the theme loads—plugin conflict, syntax error, or exhausted memory.
- robots.txt blocking important pagesCrawlers obey Disallow rules—misconfigured robots.txt can hide whole sections from search.
- Sitemap not foundCrawlers or tools could not fetch your sitemap URL—404, wrong path, or blocking rules.
- Redirect loop detectedRequests bounce between URLs without reaching a stable page—often conflicting canonicalization rules.
- Missing package.json fileNode/npm expected a package.json in this folder—the project root is wrong or the file was never created.
Edit your error
Tweak the message and run again—we'll match an existing fix or generate a new page.
Original error message
Payment gateway error — order not completed