Key Takeaways

• The official WooCommerce Stripe Payment Gateway plugin is free and built by Stripe and WooCommerce.
• It connects to your Stripe account through OAuth, so older “paste your API keys” tutorials are outdated.
• WooPayments is a Stripe-powered alternative that needs no separate Stripe account but covers fewer countries.
• WooCommerce adds no fee of its own; Stripe’s US rate is 2.9% + $0.30, plus extra for international cards and currency conversion.
• Your first Stripe payout typically takes 7 to 14 days, and Stripe says that wait can’t be waived.
• Stripe doesn’t serve every business type, so high-risk stores may need a dedicated merchant account instead.

---

Stripe is one of the most common ways to take card payments on a WooCommerce store, and unlike on Shopify, you choose your processor and plug it in. (On Shopify, Shopify Payments already runs on Stripe, which is why adding Stripe to Shopify works so differently.)

This guide covers the official setup, what Stripe actually costs, when you’ll get paid, and what to do when something goes wrong or Stripe holds your funds. There are two Stripe-powered routes on WooCommerce, and picking the right one up front saves you a migration later.

Which Stripe Option Should You Use on WooCommerce?

WooCommerce gives you two ways to use Stripe. The official plugin connects your own Stripe account and gives you Stripe’s full range of payment methods and currencies. WooPayments is WooCommerce’s own payment solution, built on Stripe and managed inside your WooCommerce dashboard, with no separate Stripe account to open. Both start at the same 2.9% + $0.30 for US card payments, so the real differences are country coverage, payment-method range, and where you manage things day to day.

So what should tip your decision? If you want Stripe’s full feature set, or you’re based somewhere WooPayments isn’t available, use the official plugin. If you’d rather keep everything in one dashboard and you’re in a supported country, WooPayments is the simpler path. If you sell internationally, compare WooPayments’ current international and currency-conversion pricing against Stripe’s before choosing, since those fees can differ.

And, if Stripe isn’t an option for your business at all, Easy Pay Direct is built for exactly that situation.

Which Countries Does Stripe Support?

Stripe itself operates in more than 40 countries, while WooPayments covers a smaller set, so check both lists for your country before choosing. Some Stripe features also vary by country, so confirm that the payment methods you want are available where you’re based.

What You Need Before You Start

You’ll need:

• A Stripe account (you can create one during setup)
• WordPress 6.9 or newer and PHP 7.4 or newer, per the plugin’s current listing
• HTTPS (an SSL certificate) on your site, which Stripe requires for live payments
• A bank account for payouts

So what does this mean in practice? Check your WordPress and PHP versions before installing, and have your business details and bank information ready, since Stripe may ask for identity and business verification before you can take live payments.

How to Add Stripe to WooCommerce

Connecting Stripe to WooCommerce takes about ten minutes with the official plugin:

1. From your WordPress dashboard, go to Plugins → Add New.
2. Search for WooCommerce Stripe Payment Gateway. Make sure the author is WooCommerce, since several third-party Stripe plugins have similar names.
3. Click Install Now, then Activate.
4. Go to WooCommerce → Settings → Payments.
5. Find Stripe in the list and click Complete setup.
6. Click Create or connect an account.
7. You’ll be redirected to Stripe, where you can connect an existing account or create a new one. Complete any business details Stripe asks for.
8. Back in WooCommerce, open the Stripe settings and confirm the Account details section shows your account as Connected and webhooks as Configured.
9. Make sure Enable Stripe is ticked, choose the payment methods you want at checkout, and save your changes.

The plugin connects through OAuth, and recent versions set up webhooks automatically, so you shouldn’t need to copy API keys or webhook secrets by hand. If a tutorial tells you to, it’s likely written for an older version. Next up is a test order, which takes about five minutes.

Is the Plugin Free?

Yes. The plugin costs nothing to install, and Stripe charges no setup or monthly fee. What you pay is Stripe’s transaction fee on each sale that processes (covered below).

Who Can You Contact for Help?

It depends on the problem. WooCommerce support can help with the plugin itself: installation, connection, webhooks, and checkout behavior. Questions about Stripe account onboarding, verification, business details, or payout settings need to go to Stripe directly, since WooCommerce support doesn’t cover those.

Test Before You Launch

When you first connect, the plugin only connects in live mode, and test mode is a separate connection. To test:

1. In the Stripe settings, click Create or connect a test account and connect in test mode.
2. Tick Enable test mode and save.
3. Place a test order using a Stripe test card, such as 4242 4242 4242 4242 with any future expiration date and any three-digit CVC. Stripe’s testing documentation lists others, including cards that trigger declines.
4. Confirm the order status updates correctly in WooCommerce and the payment appears in your Stripe dashboard’s test view.
5. Untick Enable test mode before you go live.

Because live and test are configured separately, it’s possible to be connected in one mode but not the other. The test mostly catches configuration slips, like a missing webhook or the wrong mode, which are far cheaper to find with a test order than with a real customer’s first purchase.

How Much Does Stripe Cost on WooCommerce?

This is worth knowing before you launch, not after. WooCommerce itself adds no platform transaction fee on top of Stripe’s, since it’s a free, self-hosted plugin rather than a hosted platform taking its own cut. You’ll still pay for hosting and any paid extensions, but there’s no per-transaction cut.

Here’s what Stripe charges:

See a quick worked example: 

On a $100 sale to a customer with a US card, you’d pay 2.9% + $0.30, or $3.20, netting $96.80. On a $100 sale to a customer paying with a non-US card in a different currency, the international surcharge and currency conversion stack on top: 5.4% + $0.30, or $5.70, netting $94.30 (For comparison, the same international sale through PayPal runs roughly $8 to $9 under the fees in our PayPal on WooCommerce guide).

These are Stripe’s US rates, and they vary by country, so confirm the pricing for your account’s country in your Stripe dashboard. To see how fees hit your margin on a specific product, use our eCommerce profit calculator. On Shopify, standalone Stripe also carries a Shopify surcharge; on WooCommerce, there’s no extra platform fee.

When Do You Get Paid?

This catches a lot of new store owners off guard: the first payout on a new Stripe account typically takes 7 to 14 days after your first live payment, and Stripe says that waiting period is necessary for risk mitigation and can’t be waived. It can run longer depending on your industry, and up to 30 days in some countries. After that first payout, funds follow your account’s regular payout schedule, which varies by country. New accounts also aren’t immediately eligible for Instant Payouts.

So what does this mean for you? Plan your cash flow around that first wait, especially if you’re paying for inventory or ads up front.

Which Payment Methods Can Customers Use?

The official plugin supports 23 payment methods, including Link, Apple Pay, Google Pay, and buy-now-pay-later options like Klarna, Affirm, and Afterpay/Clearpay, plus local methods such as Bancontact in Europe. Availability depends on your Stripe account’s country and your store’s currency, and each method has its own fee, with buy-now-pay-later methods typically costing more than cards, so check the rate before you enable one.

Buy-now-pay-later also depends on the buyer qualifying. If you’re a US store selling durable goods like furniture, electronics, or appliances, Katapult is a useful complement to options like Affirm: lease-to-own for shoppers with low or limited credit, with an official WooCommerce extension. It’s US-only and unavailable in a few states, so check Katapult’s WooCommerce documentation before planning around it.

Is Stripe Better Than PayPal for WooCommerce?

If you want an embedded, fully on-site checkout, lower standard card fees, and broad currency support, Stripe is a strong choice. If you want broad consumer recognition and Pay Later options, PayPal has the edge. Neither is categorically better, and many WooCommerce stores run both, giving customers a choice at checkout rather than committing to a single processor. Our PayPal on WooCommerce guide covers that side in detail, and our full processor comparison weighs all the options together.

Common Stripe for WooCommerce Problems

Beyond the setup steps, a few issues tend to show up right after launch. Here’s how to work through the most common ones.

1. Stripe isn’t Showing Up at Checkout

A handful of common, usually simple causes:

• Enable Stripe isn’t ticked. That setting controls whether Stripe’s payment methods appear at checkout.
• You’re not connected in the current mode. Live and test connect separately, so check the connection for the mode you’re actually using.
• The payment method isn’t available for your setup. Some methods have currency, country, or minimum-order limits.
• A plugin conflict or caching issue. Clear your cache after reconfiguring Stripe, and deactivate other checkout plugins to rule out a conflict.

Work through them from top to bottom, since the first two take under a minute to rule out.

2. Orders Stuck in “Pending Payment”

Stripe tells WooCommerce about payment results through webhooks, so a stuck order usually means that notification isn’t getting through. Open the Stripe settings, click Configure connection under Account details, and confirm the webhook status says Configured in both the Live and Test tabs. If it doesn’t, reconnect your account or use Reconfigure webhooks. If it does, it’s also worth checking whether a security plugin or firewall is blocking incoming requests to your store’s Stripe webhook endpoint.

3. Test Payments Getting Declined

Make sure you’re using Stripe’s test card numbers, since some are designed to trigger declines or country-specific behavior, and confirm you’re actually connected in test mode. If it still fails, reconnect your Stripe account, since a webhook may have expired or been regenerated, and check WooCommerce → Status → Logs for Stripe-related errors. You can also turn on the Log error messages setting for troubleshooting, but switch it off afterward.

4. Can’t Connect Your Stripe Account

If you’re pasting API keys and the settings page won’t save, that’s the older connection method. The plugin now requires you to connect through OAuth, so use the Create or connect an account button instead (or re-authenticate if you see that option). If your account status says “Incomplete,” finish Stripe’s onboarding in your Stripe dashboard, and contact Stripe directly for any questions about account verification.

What Happens if Stripe Holds Your Funds?

A first-payout wait of 7 to 14 days is normal and isn’t a hold. Beyond that, Stripe continually evaluates account risk, and it can pause payouts or place a reserve on your balance, with third-party sources commonly citing reserve periods of 90 to 180 days. Rising dispute rates, a higher-risk product category, and a mismatch between your business details and your bank account are among the common triggers. Stripe also maintains a list of prohibited and restricted businesses; prohibited categories aren’t permitted at all, while restricted ones may need extra approval.

The best defense is keeping disputes low and evidence ready. Tracking data supports you when a customer claims an item never arrived, and the publisher of Advanced Shipment Tracking says its Pro version syncs tracking to both PayPal and Stripe, so it’s worth a look if you’d rather not enter tracking by hand. If a dispute does reach you, Chargeflow connects to Stripe directly and lists WooCommerce as a supported platform (it’s marked “new” in its integrations documentation), automating evidence submission on a success-fee basis. Our Chargeflow review covers how it works.

And if Stripe won’t serve your business, or you keep running into holds despite doing everything right, a dedicated merchant account is the usual next step. Easy Pay Direct uses human underwriting instead of automated risk scoring, which tends to mean more account stability once you’re approved.

Final Thoughts

The biggest traps in setting up Stripe on WooCommerce aren’t in the setup itself. They’re following an outdated tutorial that has you paste API keys, being surprised by the first-payout wait, or discovering after launch that your business type needs a different kind of processor. Use the official plugin, test in both modes, plan your cash flow around the first payout, and know your backup option before you need it.

New to WooCommerce itself? WooCommerce’s own learning hub is one of the free resources in our roundup of free eCommerce training.

To ideate, plan, and launch an online business from scratch, claim your free Aurajinn launch dashboard today.

Frequently Asked Questions About Adding Stripe to WooCommerce