1. Documentation /
  2. WooCommerce Payments Documentation /
  3. WooCommerce Payments: Testing & Troubleshooting

WooCommerce Payments: Testing & Troubleshooting

WooCommerce Payments includes several tools to help you test out your store before taking actual payments. We also have a handy guide to common errors that, although rare, do occur from time to time.


↑ Back to top

Although WooCommerce Payments is designed to be as compatible and dependable as possible, errors can arise in any complex piece of software. Our troubleshooting guide contains some common errors that can occur and tips on resolving them.

Test mode

↑ Back to top

By default, WooCommerce Payments will place real charges on real payment methods, such as credit and debit cards.

WooCommerce Payments also provides an easy-to-enable test mode, which attempts to simulate the real payments process as closely as possible. This way, you can try out the various features of WooCommerce Payments on your site without charging a live payment method.

Please see our guide to using test mode for instructions on how to enable and use test mode.

The “Test mode active” warning shows when WooCommerce Payments is in test mode.

Dev mode

↑ Back to top

If you want to test WooCommerce Payments on a site that will never need to process real payments, you can use Dev Mode.

With Dev Mode, it’s possible to create a test account that requires no personal information. This account can then be used to process test transactions. It will only operate in Test Mode and cannot be used to process live transactions.

The “Test mode” setting indicating that dev mode is active.

If you are a developer or agency setting up a site for a client, we have a few guidelines that will be helpful as you do that.

Safe mode

↑ Back to top

Safe mode helps prevent issues in cases where duplicated sites are connected to the same WooCommerce Payments account, which may occur when you clone your site to or from a staging site to a live on. Please see the linked Safe Mode guide for tips on what can cause Safe Mode to be triggered, as well as how to address the issue.

Clearing the account cache

↑ Back to top

To improve performance, WooCommerce Payments caches some information inside WordPress. On occasion, you may be asked by our support team to clear this cache. To do that:

  1. Go to WooCommerce > Status > Tools page.
  2. Scroll down to the Clear WooCommerce Payments account cache tool.
  3. Click Clear.
Clearing the account cache under WooCommerce > Status > Tools

This tool will clear the cached account details so that they are immediately refreshed from the WooCommerce Payments server.


The most customizable eCommerce platform for building your online business.

  • 30-day money-back guarantee
  • Support teams across the world
  • Safe and secure online payment