WooCommerce Payment Gateway Not Working

Share
Workaround available WordPress, all hosts Updated November 13, 2026Based on 2 user reportsHow we research

Quick answer

Gateway failures come from misconfigured API keys, blocked webhooks, a cached checkout or a conflict. Check the gateway log first, then keys and mode, then conflicts.

Most likely fix: Read the gateway log

How to fix it

Try these in order — the most common fix is first.

  1. 1. Read the gateway log

    1. Go to WooCommerce > Status > Logs
    2. Open the log for your gateway and look for the error code
    Did this fix it?
  2. 2. Check settings

    1. Go to WooCommerce > Settings > Payments
    2. Confirm the method is enabled and the keys match the mode (live vs test)
    3. Check store currency and country are supported by the gateway
    Did this fix it?
  3. 3. Rule out caching and JS

    1. Exclude checkout from caches
    2. Disable JS minification
    3. Test in a private window
    Did this fix it?
  4. 4. Test for conflicts

    1. Disable other plugins and switch to Storefront
    2. Retry a payment
    Did this fix it?

Symptoms

Payment methods missing at checkout, card payments fail, or customers see a generic payment error.

Why it happens

  • Test/live mode or API keys mismatched
  • Gateway not enabled or not available for the store country or currency
  • Webhook failures
  • Checkout cached or JS broken
  • Plugin conflict

This guide also covers

  • woocommerce payment gateway not working
  • woocommerce payment error
  • woocommerce payment methods not showing

Still not working?

If WooCommerce keeps failing, you're not alone. See every WooCommerce problem users report or the alternatives people switch to.

Done fighting WooCommerce? Our small team builds your own WooCommerce alternative, or any software you need: web, mobile, games, desktop. Price agreed together.

Talk to us
Fixed it? Share this guide

The same problem in other apps

All not loading, error messages & connection guides →

Other WooCommerce errors

All 10 WooCommerce errors and fixes →