Website guides

WooCommerce Payment Gateways: How They Work and How to Choose One

By the Chargedeck team 8 min read

The short answer

A WooCommerce payment gateway is a plugin that adds a payment method to your checkout, passes the charge to a processor such as Stripe, PayPal or Square, and tells WooCommerce the order is paid. Which one is right for your store comes down to three things: where the buyer types their card details, whose account the money lands in, and whether the plugin works with the checkout your store actually runs.

This guide explains what happens behind the pay button, compares the two main types of gateway, and gives you ten questions to ask before you install one.

What a gateway does inside WooCommerce

WooCommerce looks after the catalog, the cart and the order record. It does not move money. A gateway plugin fills that gap by doing three jobs:

  1. It shows up as a payment method. You switch it on under WooCommerce, Settings, Payments, and it appears as an option on the checkout page.
  2. It hands the charge to a processor. The plugin passes the order total and currency to the company that charges the card. The money settles in an account with that processor, and the processor pays it out to your bank.
  3. It reports back. When the charge succeeds, the order moves from "Pending payment" to "Processing", or straight to "Completed" when everything in it is virtual and downloadable. That status change is what sends the confirmation email.

WooCommerce comes with a few offline methods, such as bank transfer and check payments, which park the order as "On hold" until you confirm the money yourself. Anything that charges a card needs a gateway plugin.

On-site card fields or a hosted checkout: the first decision

Gateways come in two shapes, and the difference is where the buyer enters their card.

On-site card fieldsHosted (redirect) checkout
Where the buyer paysIn card fields inside your own checkout pageOn a payment page run by the provider, then back to your store
What loads on your checkoutThe processor's card form and its scriptsA payment option only. The card form lives on the hosted page
How the order is confirmedUsually in the same visit, with a webhook as backupBy a webhook from the provider, plus a check when the buyer returns
Look and feelYour theme, one pageA second page with its own design
Tends to suitStores that want everything on one page, saved cards or subscriptionsStores that want less to maintain, or a processor their on-site plugin does not cover

With a modern gateway of either kind, the card number goes to the processor and is not stored in your WordPress database. The practical differences are how much of the payment form you have to keep working after theme and plugin updates, and whether the buyer leaves your page to pay.

Five compatibility checks that decide whether a gateway works on your store

1. The block checkout

WooCommerce has two checkout pages: the older "classic" one built from a shortcode, and the newer block checkout, which is the default on new stores. A gateway has to support the block checkout explicitly. Old gateways that only support the classic checkout do not show up in the block checkout at all, so the buyer never sees them as an option.

To find out which one you run, edit your Checkout page. If you see a Checkout block, it is the block checkout. If you see [woocommerce_checkout], it is classic.

2. HPOS

High-Performance Order Storage (HPOS) is WooCommerce's newer way of keeping orders in their own database tables instead of alongside posts and pages. Plugins have to declare that they are compatible with it, and WooCommerce flags the ones that have not. Look for HPOS compatibility in the plugin's description or changelog before you install.

3. How the order gets marked paid

A webhook is a message the payment provider sends from its server straight to your store, saying this payment succeeded. It does not depend on the buyer's browser. That matters because buyers close tabs and lose signal. A gateway that only marks the order paid when the buyer lands back on your thank-you page will leave some paid orders stuck on "Pending payment". Ask whether the gateway uses a webhook, and whether it is signed so your store can verify where it came from.

4. Currency

Your store has one base currency, set under WooCommerce, Settings, General. The gateway and the processor account behind it both have to accept that currency, or the payment method may be hidden or fail at checkout.

5. Refunds

Some gateways let you click Refund on the WooCommerce order and the processor returns the payment. With others you refund in the processor's own dashboard, then record the refund on the order so your reports stay right. Both work. Know which one you have before the first request arrives.

Ten questions to ask of any WooCommerce payment gateway

  1. Does it support the block checkout, the classic checkout, or both?
  2. Is it declared compatible with HPOS?
  3. Does the buyer pay on my page or on a hosted page, and how does that page look on a phone?
  4. Whose processor account does the money settle in: mine, or the plugin maker's?
  5. Which processors does it work with, and could I change processor later without changing plugin?
  6. Is the order confirmed by a signed webhook, and is there a backup if the webhook is late?
  7. Does it accept my store currency?
  8. Can I refund from the WooCommerce order screen, or only in the processor dashboard?
  9. Does it cover what I sell: one-off orders only, or also subscriptions and saved cards?
  10. What does it cost in total: the plugin, any monthly fee, and any percentage on top of the processor's card fee?

Work out question 10 per order. As of November 2026, Stripe's standard US online card rate is 2.9% + 30 cents per successful charge, so a $40 order costs $1.46 in card fees (2.9% of $40 is $1.16, plus $0.30). A fee like that goes to your processor whichever plugin connects you to it. What varies is what the gateway adds on top: nothing, a flat monthly fee, or an extra percentage. For any gateway's own charges, check their pricing page on the day you decide.

So which is the best WooCommerce payment gateway?

There is no single best one, but there is usually a clear best fit:

  • You want card fields on your own checkout page: use the official plugin from your processor, such as the official Stripe or PayPal plugins.
  • You sell subscriptions: you need a gateway that can save a card and charge it again. The official Stripe or PayPal plugins are the right choice here too.
  • You want as little as possible to maintain on your checkout page: a hosted checkout keeps the card form off your site.
  • You use Square, or you might move between Stripe, PayPal and Square: a hosted checkout that sits in front of all three saves you swapping plugins.
  • You take a handful of orders by bank transfer: the offline methods built into WooCommerce may be all you need.

If you are still choosing the processor itself, our comparison of Stripe, PayPal and Square covers who each one tends to suit.

Where Chargedeck fits: one hosted checkout on your own processor

Chargedeck is a checkout page builder with a free WordPress plugin. The plugin adds a hosted-checkout payment method to WooCommerce: the buyer picks it, the cart total is sent to a Chargedeck checkout, they pay there, and they come back to your store. Here is how it answers the questions above.

  • Checkout support: it works with both the block checkout and the classic checkout, and with HPOS.
  • Whose account: yours. You connect your own Stripe, PayPal or Square account, the payment goes straight into it, and that processor pays you out on its normal schedule. Chargedeck never holds the money. One plugin covers all three processors.
  • Confirmation: a signed webhook marks the order paid, with a check on the return page as a backup.
  • Currency: your store currency must be USD, GBP, EUR, CAD or AUD.
  • Refunds: you make them in your processor dashboard. They are not pushed from the WooCommerce order screen.
  • Cost: the plugin is free to download. Taking payments needs a Chargedeck plan, which is a flat monthly fee from $9.99 that takes 0% of your sales (the 7-day free trial counts). Your processor's card fees still apply. See Chargedeck pricing for the plans.

Setting it up

  1. Download the free Chargedeck plugin. In WordPress go to Plugins, Add New, Upload Plugin, choose the zip and activate it.
  2. In Chargedeck, connect your Stripe, PayPal or Square account. Then open Developers and click Reveal key to copy your API key.
  3. In WordPress go to Settings, Chargedeck, paste the key and complete the webhook details shown on that screen.
  4. Go to WooCommerce, Settings, Payments and switch on Chargedeck.
  5. Place a small test order from a phone and confirm the order moves to "Processing" by itself.

The WooCommerce setup guide has the full walkthrough. No WooCommerce? The same plugin adds a buy button block and a shortcode to plain WordPress, covered in the WordPress guide.

When a different gateway is the better choice

A hosted checkout is not right for every store, and Chargedeck has clear limits:

  • Card fields on your own page. Chargedeck is a redirect to a hosted page. If the one-page experience matters most to you, use your processor's official on-site plugin.
  • Subscriptions. Chargedeck does not do subscriptions or recurring billing.
  • Wallet buttons. Chargedeck does not offer Apple Pay or Google Pay buttons.
  • Refunds from the order screen. If your team refunds often and wants to do it inside WooCommerce, pick a gateway that supports that.
  • Other currencies. If your store currency is not one of the five listed above, you need a different gateway.

Once the gateway is chosen, look at the rest of the page: our 12 WooCommerce checkout fixes start with the ones that take minutes.

FAQ

Common questions

What is the difference between a payment gateway and a payment processor?

The processor is the company that charges the card and pays the money out to you, for example Stripe, PayPal or Square. In WooCommerce, the gateway is the plugin that connects your checkout to that processor and updates the order when the charge succeeds.

Can I run more than one payment gateway in WooCommerce?

Yes. Switch on as many as you need under WooCommerce, Settings, Payments, and drag them into the order you want buyers to see. Keep the list short.

Why is my payment method missing from the WooCommerce checkout?

The usual causes are a gateway that does not support the block checkout, a store currency the gateway does not accept, or unfinished setup such as a missing API key.

Is the Chargedeck WooCommerce plugin free?

The plugin is free to download and install. Taking payments with it needs a Chargedeck plan, a flat monthly fee that takes 0% of your sales, and the 7-day free trial counts. Card fees from your own processor still apply.

Keep reading

Related guides

Add a hosted checkout to WooCommerce

Install the free plugin, connect your own Stripe, PayPal or Square account and place your first test order today. Free for 7 days, no card.

See pricing