Plugins Plugin hub Backup SEO Caching Security Forms WooCommerce Images Best backup plugins
Hosting Hosting directory Shared Managed Cloud India
Themes & builders Compare Rank Math vs Yoast
Tools All tools Hosting finder Plugin stack builder Cost calculator Salt generator Theme detector Who is hosting this? Speed test Headline analyzer robots.txt generator Redirect generator Uptime calculator Blog name generator
Best lists Best backup plugins Deals
Guides All guides Speed up WordPress Choose hosting Back up WordPress
How we test

WooCommerce · Guide

How to Set Up Stripe in WooCommerce

How to Set Up Stripe in WooCommerce

Short answer

To set up Stripe in WooCommerce, install the free WooCommerce Stripe Gateway plugin, then connect your Stripe account from WooCommerce > Settings > Payments. Stripe redirects you to connect.stripe.com to log in or create an account, and webhooks are set up on their own when you connect.

Key takeaways

  • The Stripe Gateway needs WordPress 6.9, WooCommerce 11.0, and PHP 7.4 or newer.
  • Connect from WooCommerce > Settings > Payments; Stripe redirects you to connect.stripe.com.
  • Stripe charges 2.9% + 30 cents on domestic United States card payments.
  • Webhooks are set up on their own since extension version 8.6.1.
  • Stripe offers 23 payment methods, including cards, Link, Apple Pay, and Google Pay.
  • Version 11.2.0, released 10 November 2026, fixes security issues in older versions.

What do you need before you set up Stripe in WooCommerce?

You need a Stripe account, a site with HTTPS, WordPress 6.9 or newer, WooCommerce 11.0 or newer, and PHP 7.4 or newer.

The current WooCommerce Stripe Gateway needs WordPress 6.9 and WooCommerce 11.0, with PHP 7.4 as the minimum, according to the plugin listing and the November 2026 security update notes (checked November 2026). Older WordPress or WooCommerce versions will not be offered the update, so update those first. In live mode an SSL certificate must be installed on your site, or Stripe will not process payments.

Create the Stripe account before you start, or create one during the connection step. Stripe will ask for business details and bank details before it lets you take live payments.

Keep your existing gateway live until Stripe is tested, so checkout never goes dark during the switch.

WooCommerce itself is free and open source. Its WordPress.org plugin page lists PHP 7.4 or greater as the minimum requirement (checked November 2026).

How do you install the WooCommerce Stripe Gateway?

Install the free WooCommerce Stripe Gateway plugin from Plugins > Add New, then activate it.

Check first whether it is already installed, under Plugins > Installed Plugins. The Stripe installation docs give these steps: search for “WooCommerce Stripe Gateway,” click Install Now, then click Activate (checked November 2026). Use the official plugin built by WooCommerce, not a third-party Stripe plugin, because only the official one fully supports the checkout block and the latest Stripe payment methods.

Update to the latest version before you connect. Version 11.2.0, released 10 November 2026, fixes security issues found by Automattic, and stores on the 11.1.x line should use 11.1.2. Check your version under Plugins > Installed Plugins after install, and update it if it is older than the current release.

How do you connect your Stripe account?

Connect from WooCommerce > Settings > Payments by clicking Complete setup beside Stripe, then Create or connect an account.

The Stripe connection docs describe the flow: click Create or connect an account, and Stripe redirects you to connect.stripe.com to log in to an existing account or create a new one (checked November 2026). After you connect, Stripe sends you back to the WordPress admin. Use the “Create or connect a test account” button only for a test-only Stripe account.

Confirm the connection in the Account details section. The statuses for Payment, Payout, Webhook, and Sync should all show green or Enabled.

If any status is not green, open the Configure connection button and follow the prompts before you take live payments. A store with a half-finished connection can take a payment and then fail to record it.

Which payment methods can you offer through Stripe?

Stripe offers 23 payment methods out of the box, including cards, Link, Apple Pay, Google Pay, Klarna, Affirm, and Afterpay.

The official plugin description lists 23 payment methods, plus local methods such as Bancontact in Europe and Alipay in Asia Pacific, according to the plugin readme on WordPress.org (checked November 2026). Stripe supports cards in 135+ currencies and works for merchants in 46 countries.

Turn on the methods your buyers use, and leave the rest off.

Cards should be first, with Apple Pay and Google Pay beside them for mobile buyers. Buy now, pay later methods such as Klarna, Affirm, and Afterpay suit higher-priced orders, but they add a fee and a new step at checkout.

Test each method you enable with a real device, because Apple Pay needs domain verification and HTTPS before the button appears. For the fee side, see WooCommerce payment gateway fees compared.

What fees does Stripe charge?

Stripe charges 2.9% plus 30 cents per successful domestic card payment in the United States, with extra fees for international cards and currency conversion.

Stripe pricing lists 2.9% plus 30 cents for domestic cards, plus 1.5% for international cards and 1% when currency conversion is needed (checked November 2026). There are no setup fees or monthly fees for standard Stripe Payments. A $50 domestic card order costs $1.45 plus $0.30, which is $1.75 in total.

Volume discounts and custom pricing exist for large stores, but most small stores pay the standard rate. Compare the Stripe rate with WooPayments in WooPayments vs Stripe before you choose a primary gateway.

FeeRateWhen it applies
Domestic card payment2.9% + $0.30Card issued in the United States
International card+1.5%Card issued outside the United States
Currency conversion+1%Payment needs conversion to your currency
Dispute$15.00A customer disputes the charge through their bank

How do webhooks work with the Stripe extension?

Webhooks let Stripe tell your store about payment events, and the extension has set them up on its own since version 8.6.1.

The Stripe webhooks docs state that webhooks are set up when you connect to Stripe, so there is no need to set them up by hand (checked November 2026). Stripe talks to the extension through webhooks, while the extension talks to Stripe through the API. Without working webhooks, payments can succeed at Stripe but never update the order in WooCommerce.

Check the webhook status in WooCommerce > Settings > Payments > Stripe > Settings. Open Configure connection in the Account details section and confirm the Live tab and the Test tab both say Configured. The extension only uses webhook endpoints in the form /?wc-api=wc_stripe on your own domain, so any other Stripe endpoint in your Stripe Dashboard comes from another gateway or tool.

If the status is not Configured, click Reconfigure webhooks on each tab. See how to fix WooCommerce Stripe webhook errors if the status stays red.

How do you test Stripe payments before going live?

Test with Stripe test mode and the test card numbers Stripe publishes, so no real money moves.

Connect a test account or switch the gateway to test mode, then place test orders for each payment method you enabled. Use the test card 4242 4242 4242 4242 for a successful payment, and the test cards Stripe lists for declines and for 3D Secure checks. Confirm each test order appears in WooCommerce with the right status, and confirm the payment shows in the Stripe Dashboard test view.

Test Apple Pay and Google Pay on real phones, because the buttons only show when the device and browser support them. Also test a card that needs 3D Secure, since that flow asks the buyer to confirm the payment with their bank before the order completes.

Stripe publishes test cards for 3D Secure, and the order should stay pending until the buyer confirms. Test a subscription renewal if you sell subscriptions, since renewals run through webhooks and saved cards.

Switch back to live mode only after every test passes, and then place one small real order to confirm live payments work. For the wider safety checks, see is WooCommerce PCI compliant.

What should you check when a Stripe payment fails?

Check the connection statuses, the webhook status, and the plugin version before you change any checkout settings.

Open WooCommerce > Settings > Payments > Stripe > Settings and confirm Payment, Payout, Webhook, and Sync are all green. If the webhook status is not Configured, reconfigure it from the same screen.

Then check that the gateway version is current, because version 11.2.0 from 10 November 2026 fixes issues that older versions carry. An old gateway can fail on new checkout setups even when the connection looks fine.

Look at the order notes in WooCommerce for the error Stripe returned, and check the payment in the Stripe Dashboard for the decline reason. A card declined by the bank needs the buyer to try another card, while an error about the connection needs a fix on your side.

Keep the Stripe Dashboard open while you test, because it shows each attempt with its result. For the checkout settings around the gateway, see how to customize the WooCommerce checkout.

Frequently asked questions

Does Stripe charge a monthly fee?

No, standard Stripe Payments has no setup fees or monthly fees. You pay per transaction: 2.9% plus 30 cents for domestic United States card payments, plus 1.5% for international cards and 1% when currency conversion is needed. Disputes cost $15 each.

Can I take payments in other currencies with Stripe?

Yes. Stripe supports cards in 135+ currencies and works for merchants in 46 countries. Turn on the currencies your buyers use, and check the fee for each one, because international cards add 1.5% and currency conversion adds 1%.

Do I need to set up webhooks by hand?

Since version 8.6.1 of the Stripe extension, webhooks are set up on their own when you connect to Stripe. Check the status in WooCommerce > Settings > Payments > Stripe > Settings, where both the Live and Test tabs should say Configured.

How do I test Stripe without taking real payments?

Use Stripe test mode with the test card 4242 4242 4242 4242, which Stripe publishes for successful test payments. Place test orders for each payment method you enabled, then switch back to live mode and place one small real order.

Why did a Stripe payment fail at checkout?

First confirm Payment, Payout, Webhook, and Sync are all green in the Stripe settings, then check the plugin version. Version 11.2.0, released 10 November 2026, fixes security issues in older versions. Read the order notes for the decline reason Stripe returned.

Sources

  1. Installing the Stripe extension WooCommerce
  2. Connecting to a Stripe account WooCommerce
  3. Setting up webhooks (Stripe) WooCommerce
  4. Pricing and Fees Stripe
  5. Test card numbers Stripe Docs
  6. WooCommerce – WordPress plugin WordPress.org

Is your product missing, or something out of date?

Tell us what to add or correct. We read every note and reply when we need a source. A message does not buy a ranking.

About the editors

WPLegible editors

Researched from the primary sources listed above and checked against our editorial rules. About the site · How we test