WooCommerce Payments Test Account Setup Guide

WooCommerce Payments is available to stores based in the US. Based outside the US? Request to be notified when it becomes available in your country.

To set up WooCommerce Payments, you need to verify your identity, even if you only need to process test transactions. This verification requires supplying personal or business data, like a bank account and Social Security Number.

If you are setting up WooCommerce Payments for someone else, like a client, on a store that will process real payments you should have the site owner complete the WooCommerce Payments setup. This ensures that the correct personal and business details are set on the account.

Once the store owner set up has been completed, you can then use Test Mode to simulate payments, refunds and disputes.

Dev Mode ↑ Back to top

If you are setting up WooCommerce Payments on a test 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 test account can then be used to process test transactions. It will only operate in Test Mode and can never be used to process live transactions.

Enable Dev Mode ↑ Back to top

To enable Dev Mode, you can either:

  1. Ensure your WordPress site’s environment is set to either 'development' or 'production' using the WP_ENVIRONMENT_TYPE constant.
  2. Manually enable Dev Mode on other environments by adding the following code snippet to your site’s wp-config.php file:
define( 'WCPAY_DEV_MODE', true );

Note: Dev Mode must be enabled before completing the account set up and verification process in order to create a test account. If it is enabled after, the

Confirm Dev Mode is Enabled ↑ Back to top

To check if Dev Mode is enabled when on the WooCommerce > Setup payments task:

  1. Click Set up
  2. Confirm TEST DATA is displayed on the onboarding screen
WooCommerce > Setup payments task screenshot
WooCommerce > Setup payments task

To check if Dev Mode is enabled outside on the WooCommerce setup process:

  1. Go to Payments
  2. Click Verify details
  3. Confirm TEST DATA is displayed on the onboarding screen
Onboarding a test account

Setup Test Details ↑ Back to top

After Dev Mode is enabled, you can complete setup with the following details:

  • Email: any valid e-mail address.
  • Mobile Number: 0000000000. Click test phone number to enter it automatically.
  • Phone verification code: 000000. Click Use test code to enter it automatically.
  • Name & date of birth: enter any name and a date of birth in the past.
  • Address: enter a valid US street address.
  • Last 4 digits of Social Security Number: 0000.
  • Industry / Business website: enter any industry & website URL.

Once setup is completed, the account can then be used to test payments, refunds and disputes in Test Mode.

Change Account ↑ Back to top

It is not possible for the WooCommerce Payments account connected to a store to be changed without assistance from the WooCommerce team.

If you have set up a store for someone else using your own personal or business information, or set up a store in Dev Mode that needs to use a live account, please contact support to request the existing account be disconnected.

WordPress Environment Type ↑ Back to top

WooCommerce Payments uses WordPress’s wp_get_environment_type() function to monitor the site’s environment. If a site’s environment is set to either 'development' or 'staging', then Dev Mode will be automatically enabled.

Environment Changes ↑ Back to top

If you set up a site on in the production environment, then copy that site to a staging or development environment, and the site has never been in Dev Mode before, you will need to complete the account set up and verification process again using the test details on the new environment. This will create a new test account for use while in Dev Mode on that site.

Your transaction data from the production environment will not be available while in Dev Mode on the staging or development environments. It will remain available on the production environment.

Disable Dev Mode ↑ Back to top

If you need access transaction data from the production site on the staging or development site, the 'wcpay_dev_mode' filter can be used to disable Dev Mode.

To disable Dev Mode, add the following snippet to your wp-config.php file:

add_filter( 'wcpay_dev_mode', '__return_false' ); 

WooCommerce - the most customizable eCommerce platform for building your online business.

Back to the top