Spanish version of this page | Aquí 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 help troubleshoot WooPayments errors that, although rare, do occur from time to time.
Failed payments
↑ Back to topPayment failures (also called “declines”) can happen for a number of reasons. Most often, they occur because the card issuer has declined the charge, or some other system has blocked it. Only rarely do they signify an actual error with WooPayments.
To learn more about why payments might fail, please see this document.
Troubleshooting
↑ Back to topWooPayments 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 topBy 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 payment 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.
Sandbox mode
↑ Back to topIf you want to try 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 run any real transactions.
If you’re a WordPress developer or agency working on a site for a client, we have a few helpful guidelines that you may want to consult as well.
Safe mode
↑ Back to topSafe 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 trigger Safe Mode, 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.
Cleaning up after testing
↑ Back to topAll orders placed in test mode or sandbox mode have the _wcpay_mode
meta key set to test
. This can help you easily find test/sandbox mode orders and clean up after you finish testing WooPayments.
Clearing the account cache
↑ Back to topTo improve performance, WooPayments caches some information in the WordPress database. On occasion, our support team may ask you to clear this cache. To do so:
- Go to WooCommerce > Status > Tools page.
- Scroll down to the Clear WooPayments account cache tool.
- Click Clear.
This tool will clear the cached account details so that they are immediately refreshed from the WooPayments server.
Remove WooPayments from your site’s database
↑ Back to topThe WooPayments plugin is designed for seamless activation and deactivation, without causing compatibility issues with other payment gateways or plugins on your site. If you wish to remove WooPayments data from your site’s database, follow these steps carefully:
- Uninstall the WooPayments plugin – Start by uninstalling and deleting the WooPayments plugin from your WordPress site.
- Search for WooPayments data in the database – Search your site’s database for entries in the
wp_options
table whereoption_name
includeswcpay
. You can consider deleting these entries, but proceed with caution.
Please also note that:
- WooPayments does not create its own database tables.
- The
wp_woocommerce_payment_tokens
andwp_woocommerce_payment_tokenmeta
tables belong to WooCommerce core. Do not delete these tables, as they are essential for WooCommerce functionality, regardless of the payment gateway you use. - WooPayments stores custom values in the
wp_postmeta
table for payment information related to orders. - WooPayments uses entries in the
wp_options
table to manage settings and state. However, our servers, rather than your database, store transaction details (via Stripe).
Warnings and recommendations
↑ Back to top- Avoid Deleting Data
We strongly advise against deleting database records, as this can cause unintended issues. - Backup Your Site
Always back up your site before making any database changes. Consult your hosting provider if you’re unsure how to proceed. - Scope of Support
Making changes to your site’s database is beyond the scope of our support policy. We cannot provide direct assistance with implementing these steps.
Need help?
↑ Back to topIf you would like to seek assistance from a qualified WordPress/WooCommerce developer, we highly recommend Codeable or a Woo Agency Partner.