
Stripe Checkout Payments for WooCommerce
Stripe Checkout for WooCommerce: cards, Apple Pay and Google Pay on the Stripe page, any currency; Pro adds refunds, time to pay, a background check and a log.
- Compatibility
- WordPress 6.4+ · WooCommerce 8.6+ (HPOS, block checkout) · PHP 7.4+ · a Stripe account · Stripe currencies · interface: English, Deutsch, Français, Español (in Pro)
- Licence
- a site + a staging copy, annual
- Trial
- 7 days, no card, one per site
- Updated
- 19.11.2026
What Free has,
and what Pro adds
The free version works with no time limit. Pro adds the rest of the features in the table.
Key points
What happens to the order
At the checkout the buyer sees the “Credit / Debit Card” method (the title, description and button text can be changed) with a note that the payment happens on the secure Stripe page.
What Pro adds
Refunds from WooCommerce. A full or partial refund from the order goes to Stripe, and the order keeps a note of it.

The trial starts when you ask
A fresh install is the free version, nothing switches on by itself. The “Try Pro for 7 days” button → e-mail → the key right in the window and by e-mail.

One key — a site and a staging copy
Moving the site? Unlink the licence on the old domain and activate it on the new one yourself. A staging copy (staging., dev.) works with the same key and does not take a site slot. For studios — keys for 5 or 25 sites, or unlimited.
Technical requirements
WordPress 6.4+, WooCommerce 8.6+ (HPOS and the block checkout are supported), PHP 7.4+.
A Stripe account and its secret key; for the webhook, a site on HTTPS reachable from the internet.
Store currency: any currency Stripe takes for your account.
Version history
Payment on the Stripe Checkout page, order lines with options and images, every Stripe currency, confirmation on return and by a signed webhook, one-button webhook setup, delayed payment…
Frequently bought with Stripe Checkout Payments


Klaviyo Connector for WooCommerce — store events, profiles and subscriptions in Klaviyo

Product bundles and gift with purchase for WooCommerce

One-Click Order — Quick Order for WooCommerce
Full module description
Stripe Checkout Payments for WooCommerce adds Stripe Checkout to WooCommerce: the buyer presses “Continue to payment”, pays on the secure Stripe-hosted page (checkout.stripe.com) and comes back to the order confirmation. Card details never touch your shop, 3-D Secure is handled by Stripe, and the page offers the methods you switched on in your Stripe Dashboard: cards, Apple Pay, Google Pay, Link and others available in your country. The module works with your own Stripe account and with any currency Stripe takes.
What you need from Stripe. Your own Stripe account and its secret key from Stripe Dashboard → Developers → API keys (sk_test_… for Stripe test mode, sk_live_… for live). Stripe has to activate the account before live payments. Payment methods are switched on in Stripe Dashboard → Settings → Payment methods.
What happens to the order
At the checkout the buyer sees the “Credit / Debit Card” method (the title, description and button text can be changed) with a note that the payment happens on the secure Stripe page. While the title, description and button are left at their defaults, the buyer sees them in their own language: English, German, French or Spanish.
The same on the block checkout, phones included. The module checks the cart currency against the list of Stripe currencies: for a currency Stripe does not take, the method is not offered.
On the Stripe page every product is its own line: quantity, price including tax and discounts, the product image and the item options the shop shows on the order (size, colour, add-on fields), plus fees and shipping. When the lines would not add up to the order total to the cent, Stripe shows one line “Order #N” with the exact total: the buyer always pays exactly the order total. Amounts go in the currency’s minor unit, including zero-decimal currencies (JPY, KRW, CLP, VND…) and three-decimal ones (KWD, BHD, JOD, OMR, TND).
The module confirms the payment twice and counts it once: when the buyer comes back (the confirmation page already shows the paid order) and when the Stripe webhook arrives, even if the buyer closed the tab. The order is marked paid only when the Stripe session belongs to it (order number and order key) and the amount and currency are the order’s own; a different amount puts the order On hold with a note. Repeated or late events change nothing, and a paid order is never set back. A method the bank confirms later keeps the order On hold until Stripe reports the result; a refusal fails the order.
“Back” on the Stripe page returns the buyer to the checkout with the cart intact and a short notice. A new attempt closes the page of the previous one, so one order cannot be paid twice. On the order screen the Stripe Checkout box shows the mode, the payment and the session with links to the Stripe Dashboard, and a “Check payment status” button.
What Pro adds
Refunds from WooCommerce. A full or partial refund from the order goes to Stripe, and the order keeps a note of it.
Refunds from the Stripe Dashboard. A refund made right in Stripe arrives by webhook and is recorded on the order as a WooCommerce refund: the totals and the Refunded status follow what really happened.
Time to pay. How long the Stripe page stays open: 30 minutes to 24 hours. Optionally the unpaid order is cancelled when its page expires, and the stock goes back.
Hourly check. Unpaid orders of the last 3 days are checked with Stripe in the background: if a webhook did not arrive, the order is closed anyway.
Payment log. The last 200 payments, webhook events, refunds and errors on the settings page.
Translations and updates. German, French and Spanish interface and updates from catcode.com.ua right in the admin.
Limitations
- The module works only with your Stripe account: you sign up and get the account activated with Stripe.
- The methods on the Stripe page are those enabled in your Stripe Dashboard and available for the currency, the amount and the buyer’s country.
- The webhook needs the site reachable from the internet over HTTPS. Without it a payment is confirmed when the buyer comes back, but not when the buyer closes the tab after paying, and delayed methods are not settled.
- Stripe has a minimum charge per currency (for example 0.50 USD or 50 JPY).
- No conversion into the buyer’s currency: the buyer pays exactly the order total in the store currency.
- Product images are sent to Stripe only from public HTTPS addresses.
- The interface is in English; German, French and Spanish come with the Pro build.
How it works, step by step
- Install and activate the plugin (WooCommerce must be active).
- In Stripe Dashboard → Developers → API keys copy the secret key.
- WooCommerce → Settings → Payments → Stripe Checkout (redirect): paste the key, save and press “Set up the webhook” — the module creates the endpoint with the events it needs and saves its signing secret.
- Enable the method. “Check the key” shows whether the key works and belongs to that mode.
- The buyer chooses card payment, pays on the Stripe page and returns to the order confirmation; the order becomes Processing as soon as Stripe confirms the payment.
- In Pro switch on time to pay, cancelling unpaid orders, the background check and the log; refund right from the order.
Under the hood
- The module calls the Stripe API (api.stripe.com) only with your secret key. Card details are entered on the Stripe page.
- Secret keys and webhook signing secrets are stored encrypted in the database and never printed in HTML.
- A webhook event counts only with a valid Stripe signature at most 5 minutes old. The event mode is checked against the secret it was signed with.
- A lock on the order: the buyer coming back and a webhook arriving at the same moment count the payment once. Every payment attempt has its own idempotency key.
- Stripe receives the order lines (names, quantities, prices, options, image address), fees and shipping, the currency, the order number and key, the site address, the buyer’s e-mail and the return addresses. The Stripe API version is pinned.
Installation
- Plugins → Add New → Upload Plugin: choose the zip and activate.
- WooCommerce → Settings → Payments → Stripe Checkout (redirect): paste the secret key, save, press “Set up the webhook”.
- Enable the method and save.
- For Pro: paste the licence key or start the trial in the “Licence” section on the same page.
Questions
about the module
Didn't find the answer? Message us on Telegram and we'll reply within a business day.
Is this an official Stripe plugin?
No, it is an independent integration by CatCode. Stripe is a trademark of Stripe, Inc.; the plugin is not affiliated with or endorsed by Stripe.
Do I need a Stripe account?
Yes, your own. The plugin does not do the sign-up, and Stripe has to activate the account before live payments.
Do card details pass through my shop?
No. The buyer enters them on the Stripe page; only the result comes back to the shop.
Does the webhook have to be set up?
It is strongly recommended. Without it a payment is confirmed when the buyer comes back, but not when the buyer closes the tab after paying. The webhook is set up with one button, "Set up the webhook".
Which payment methods will the buyer see?
Those enabled in Stripe Dashboard → Settings → Payment methods and available for the currency, the amount and the buyer's country: cards, Apple Pay, Google Pay, Link and others.
Which currencies?
The store currency, if Stripe takes it for your account, including zero-decimal and three-decimal currencies. For other currencies the method is not offered at the checkout.
Why is the order "Pending payment" after checkout?
It waits for the buyer to pay on the Stripe page and moves to Processing as soon as Stripe confirms the payment.
Can I refund?
Yes, in Pro: a full or partial refund from the WooCommerce order goes to Stripe, and refunds from the Stripe Dashboard are recorded on the order.
How many sites does a key cover?
One key works on two sites: the shop and its development copy.
No reviews yet. Be the first.
No questions yet. Ask one — we answer within 24 hours.
Not quite what you are looking for?
We build custom modules for WordPress, WooCommerce, OpenCart and Shopify. Tell us about the task and we'll prepare an estimate.
Order a custom module
Buying the module
—
Charged in UAH; your bank converts it to your currency. EUR price is approximate.




















