WooPayments requires a connection to WordPress.com in order to function properly. This connectivity is facilitated through the same process that the Jetpack plugin uses to connect to WordPress.com.
As such, Jetpack can be a helpful tool for reconnecting WooPayments if the connection is disrupted, or changing the connected WordPress.com account entirely.
NOTE: The Jetpack plugin itself is not required for WooPayments to function. It’s only used here to help configure the connection to WordPress.com.
Setting up the connection to WordPress.com
↑ Back to topAfter you’ve activated WooPayments for the first time, you’ll be prompted to connect to WordPress.com. If you don’t have a WordPress.com account, one will be created for you after entering your email address. This process does not automatically install Jetpack.
If you already have Jetpack installed and connected to WordPress.com, then you won’t need to connect WooPayments separately. It will simply use Jetpack’s connection. If you remove Jetpack at a later date, the WooPayments connection will not be broken.
Changing the WordPress.com account you’re connected to
↑ Back to topIf you want to change the WordPress.com account that your WooPayments website is connected to, you can use Jetpack to sever the connection between your site and WordPress.com, and then reconnect to an account of your choosing.
This is an important step to take if you’re trying to transfer ownership of your site to someone else, or if you’re an an agency or developer that connected a client’s site to WordPress.com temporarily.
To change which WordPress.com account your site is connected to, follow these steps:
NOTE: After you click the Disconnect button in the steps below, WooPayments will be unable to take payments until reconnected to WordPress.com. Thus, we suggest that you reconnect to the new account as quickly as possible. If you are at all unsure of how to proceed, please contact our support for guidance.
- Install and activate Jetpack on your site per this document.
- It will automatically connect to whichever WordPress.com account you used during the WooPayments signup process. This is only temporary.
- If you don’t want Jetpack to auto-enable any features while you do this, you can return an empty array to the
jetpack_get_default_modulesfilter as shown here. This snippet should be added before installing Jetpack.
- Disconnect Jetpack following these instructions.
- You will see a popup indicating that this will break WooPayments.
- Click the Disconnect button.
- Click the No thank you link.
- Jetpack and WooPayments are now disconnected from WordPress.com.
NOTE: At this point, you can safely remove Jetpack from your site if you no longer wish to use it. To remove Jetpack, navigate to Plugins > Installed Plugins. Once there, deactivate Jetpack and delete it.
- Go to the WordPress.com profile page and click the Log Out button.
- This will log you out of WordPress.com so that, when you reconnect WooPayments, you can connect to any WordPress.com account you choose.
- Go back to the admin dashboard of your site.
- Click the Payments menu.
- Click Finish Setup.
- Connect to a WordPress.com account of your choosing.
- Once you are connected to any WordPress.com account, WooPayments will automatically be connected to the same Stripe Express account as before.
NOTE: After the site is reconnected to WordPress.com, WooPayments will resume working normally. This will happen automatically without any other steps needed.
Troubleshooting
↑ Back to topIf you’re having trouble connecting WooPayments, please see the advice below, or contact our support team for assistance.
If you’re having trouble creating a WordPress.com account or accessing that account, please contact our WordPress.com support team.
Resetting the WordPress.com connection
↑ Back to topOccasionally (e.g. after restoring your site from a backup), WooPayments may become disconnected from WordPress.com. To fix this problem, you can use Jetpack to reset the connection so that it works again.
To reset the connection, follow the steps above. However, instead of reconnecting your site to a different WordPress.com account, reconnect to your original account instead. WooPayments will use Jetpack’s connection to re-establish itself.