Connecting to a Stripe account

The Stripe extension lets you connect your Stripe.com account to WooCommerce so that you can process payments securely. This document covers how to make that connection.

If you haven’t already created a Stripe account, you will be given the opportunity to create one during the connection process.

If you do already have a Stripe account, logging into it prior to connecting our Stripe extension will make the connection process easier.

Once you’ve installed the Stripe extension, you can connect to Stripe like so:

1. Navigating to WooCommerce > Settings > Payments tab.
2. Click the Finish set up button for the Stripe payment method.

3. Click the Create or connect an account button.
   • Clicking the Create or connect a test account button should only be used if you’re connecting to a test-only Stripe account.
4. You’ll be redirected to connect.stripe.com where you can either connect to an existing Stripe account or create a new one.

5. Whether you simply connected to an existing account you were already logged into or created a brand new Stripe account, you’ll be redirected back to the WordPress admin dashboard once you’ve connected our Stripe extension.
6. In the Account details section, click the Configure connection button.

7. Ensure that your account is connected and that webhooks are configured.

Once that’s done, you’re all set to start using the Stripe extension!

If you see this error message while trying to connect to your Stripe account:

… it could indicate one of a few problems with the connection process:

• Your site may not be served over HTTPS, which is required for the connection.
• Your site may not be reachable from the Internet, e.g. it’s hosted locally.
• Our systems at WooCommerce.com might be offline temporarily.

If you wait 5 minutes, try again, and it still does not work, reach out to support.

If you ever click the Configure connection button and notice that your account status is “Incomplete”, you may need to re-authenticate your Stripe account.

Please complete the steps on this page to re-authenticate your account.

Stripe requires that each website you operate use its own Stripe account, even if it’s possible (via our plugin) to use the same Stripe account on more than one site.

That said, merchants are permitted to re-use the same tax ID and business information across multiple accounts if they perate under the same legal entity.

Once you’ve connected our Stripe extension to a Stripe account, you’ll need to adjust some settings to ensure that your site receives all of the information it needs to handle payments successfully.

As a next step, we recommend configuring test mode and adjusting the settings.