WooCommerce Payment Setup Guide 2026: The Ultimate Tutorial to Accepting Payments

A quick note before diving in: the WooCommerce payment gateway setup was touched on briefly in the Cloudways WooCommerce guide. This article goes through the full process in detail — every major gateway, step by step.

Payment settings live at WooCommerce → Settings → Payments. Once you're in, WooCommerce suggests available payment methods based on your store's configured country. Before installing any payment plugins, this page shows only two defaults — Bank Transfer and Cash on Delivery. Neither is useful for cross-border retail. You need Stripe and PayPal plugins installed before actual payment collection becomes possible.

Installing the Payment Plugins

Go to Plugins → Add New, search for the following, and install and activate both:

WooCommerce Stripe Payment Gateway — Stripe's official plugin. Actively maintained, supports credit cards, Apple Pay, Google Pay, and buy-now-pay-later options including Klarna and Afterpay.

WooCommerce PayPal Payments — PayPal's official plugin. Covers PayPal wallet checkout, direct credit card collection with PayPal as the acquirer, and PayPal Pay Later.

Install and activate both. Then go back to WooCommerce → Settings → Payments — both methods will now appear in the list, but they're not yet connected to merchant accounts and are in an inactive state.

Connecting Your Merchant Accounts

Connecting Stripe: Find Stripe in the Payments list and click Manage (or Set up). In the plugin settings page, click Connect with Stripe. This redirects to Stripe's authorization page — log in with your Stripe account and authorize WooCommerce to access it. After authorization, you're returned to the WordPress dashboard automatically. You'll see that the Publishable Key and Secret Key have been filled in automatically. If you prefer to enter these manually, find them under Stripe Dashboard → Developers → API Keys.

Connecting PayPal: Find PayPal Payments in the Payments list and click Set up. In the plugin settings, click Connect to PayPal. This follows the same pattern — a redirect to PayPal's authorization page, log in with your PayPal Business account, complete the authorization, and you're brought back with the connection established.

Once both are connected, toggle the Enable switch for each method in the Payments list. The order can be dragged to rearrange — putting credit card (Stripe) first and PayPal second matches the checkout habit pattern most common among Western shoppers.

Enabling Apple Pay and Google Pay

Once the Stripe plugin is active, Apple Pay and Google Pay can typically be switched on directly in the plugin settings without any separate application process.

Go to WooCommerce → Settings → Payments → Stripe → Manage and find the Express Checkouts or Payment Request Buttons section. Toggle Apple Pay and Google Pay on. The checkout experience improvement for mobile users is significant — leaving these off is leaving conversion on the table.

One prerequisite worth confirming: Apple Pay won't display on a site without HTTPS. Make sure your SSL certificate is properly installed before expecting this to work.

Before Going Live: Run the Full Test First

Don't open the store to real customers before testing the entire payment flow in test mode.

Stripe test mode: Enable Test Mode in the Stripe plugin settings, then place a test order using Stripe's test card numbers. The most commonly used test card is:

Card number: 4242 4242 4242 4242
Expiry: any future date (e.g. 12/28)
CVV: any three digits (e.g. 123)

This simulates a successful credit card payment. Stripe also provides test card numbers for simulating failures, 3D Secure authentication, and other scenarios — the full list is in Stripe's official Testing documentation.

PayPal Sandbox: Switch to Sandbox mode in the PayPal plugin settings, then create a Sandbox buyer account in the PayPal Developer Dashboard to use for testing.

The complete flow to verify: add a product to cart → confirm payment options appear at checkout → complete a test payment → order appears in the backend → order status updates to Processing → buyer receives order confirmation email → seller receives new order notification email. Once every step in that chain checks out, turn off Test Mode, switch back to production, and the store is ready for real transactions.

Troubleshooting Common Issues

"No payment methods available" at checkout: This is the most common configuration issue on new stores. The usual causes: the Stripe or PayPal plugin is installed but the method hasn't been enabled on the Payments page (the Enable toggle is still off); the plugin is installed but the merchant account connection wasn't completed; the store's configured currency or country doesn't match what the plugin supports; or test mode is active but the test API keys weren't entered correctly.

Go to WooCommerce → Settings → Payments and check that each payment method's toggle shows as active (green). Then open each plugin's settings page and confirm the API keys are present and the account shows as connected. That two-step check usually pinpoints the issue.

Stripe payment failures or checkout errors: The most common cause is mixed-up API keys — using a production key in test mode or vice versa. Webhooks are another common culprit. Go to Stripe Dashboard → Developers → Webhooks and add an endpoint pointing to your site (typically https://yourdomain.com/?wc-api=wc_stripe). This keeps order status synced from Stripe to WooCommerce in real time — without it, orders may not update correctly after payment.

Recommended Payment Method Combination

For a cross-border independent store targeting Western markets, this combination covers the vast majority of scenarios:

Payment flexibility is one area where WooCommerce genuinely outperforms Shopify — every payment method the Stripe plugin supports can be enabled independently, with no platform restrictions on which gateways you can use or how you combine them.