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.

Creating a Stripe account

↑ Back to top

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.

NOTE: The WooCommerce support team does not provide technical support for Stripe accounts and cannot assist with account-related inquiries. If you need help with your Stripe account, you should contact Stripe directly.

Connecting to a Stripe account

↑ Back to top

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.
  1. Click the Create or connect an account button.
  2. You’ll be redirected to connect.stripe.com where you can either connect to an existing Stripe account or create a new one.
  1. 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.
  2. In the Account details section, click the Configure connection button.
  1. 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!

Troubleshooting the connection

↑ Back to top

“An issue occurred generating a connection to Stripe”

↑ Back to top

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.

“Incomplete” account status

↑ Back to top

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.

Going further

↑ Back to top

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.

Use of your personal data
We and our partners process your personal data (such as browsing data, IP Addresses, cookie information, and other unique identifiers) based on your consent and/or our legitimate interest to optimize our website, marketing activities, and your user experience.