1. Documentation /
  2. WooPayments Documentation /
  3. WooPayments: Testing & Troubleshooting

WooPayments: Testing & Troubleshooting

Spanish version of this pageAquí puedes encontrar la versión en español de esta página

WooPayments includes several tools to help you test things out in 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

WooPayments is designed to be dependable and broadly compatible with other plugins, but problems can occur in any complex piece of software. Our self-service guide explains how to resolve many common issues.

If need be, you can contact our support staff for assistance. Before doing so, however, it may help to enable logging first, since that is a common step required to diagnose many issues.

Test mode

↑ Back to top

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

WooPayments also provides an easy-to-enable test mode, which simulates the real payments process as closely as possible. This way, you can try out the various features of WooPayments 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 WooPayments is in test mode.

Sandbox mode

↑ Back to top

If you want to try out WooPayments on a site that does not need to process real payments, you can use sandbox mode. This can come in handy on staging sites and the like.

With sandbox 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.

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 WooPayments account, which may occur when you clone your site to or from a staging site to a live one. Please see guide linked above for tips on what can cause Safe Mode to be triggered, as well as how to address the issue.

Safe mode should almost never be triggered deliberately. Instead, we suggest using sandbox mode on staging sites.

Clearing the account cache

↑ Back to top

To improve performance, WooPayments caches some information in the WordPress database. On occasion, you may be asked by our support team to clear this cache. To do so:

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

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