How to configure payment gateways on WooCommerce

intermediate 8 min read Updated 2026-03-18

Quick Answer

Configure WooCommerce payment gateways by navigating to WooCommerce Settings > Payments, then enable and configure your desired payment methods with API keys and settings. Most gateways require merchant accounts and API credentials to process transactions securely.

Try WooCommerce Full WooCommerce Review

Prerequisites

WordPress website with WooCommerce plugin installed
Administrative access to WordPress dashboard
Merchant accounts with desired payment providers
SSL certificate installed on your website

Step-by-Step Instructions

Access WooCommerce Payment Settings

Log into your WordPress admin dashboard and navigate to WooCommerce > Settings. Click on the Payments tab at the top of the page. This will display all available payment gateways including default options like PayPal Standard, Stripe, and Check payments.

Ensure your WooCommerce plugin is updated to the latest version for access to newest payment gateway features.

Enable Your Desired Payment Gateway

Locate the payment gateway you want to configure from the list. Toggle the Enable/Disable switch to the On position. The gateway will now show as Enabled with a green indicator. Click Set up or Manage next to the gateway name to access configuration options.

Start with one payment gateway at a time to avoid configuration conflicts during setup.

Configure Basic Gateway Settings

In the gateway settings page, enter a Title (what customers see during checkout) and Description. Set the gateway to Test Mode initially by checking the test mode checkbox. This allows you to process test transactions without charging real money while you configure the system.

Enter API Credentials and Keys

Input your merchant account credentials including API Key, Secret Key, and Merchant ID in the designated fields. For PayPal, enter your PayPal Email Address. For Stripe, add your Publishable Key and Secret Key. These credentials are provided by your payment processor when you create a merchant account.

Store API keys securely and never share them publicly. Use test credentials first before switching to live keys.

Configure Advanced Settings

Set up additional options such as Payment Action (Capture or Authorize), Accepted Credit Cards, and Currency Settings. Enable features like Saved Payment Methods for returning customers and configure Webhook URLs if required by your payment processor for transaction notifications.

Webhook URLs help ensure payment status updates are received even if customers don't return to your site after payment.

Test the Payment Gateway

With test mode enabled, place a test order using the configured payment method. Use test credit card numbers provided by your payment processor (e.g., 4242424242424242 for Stripe). Verify that transactions process correctly and order statuses update appropriately in your WooCommerce orders dashboard.

Switch to Live Mode and Save Settings

After successful testing, disable Test Mode and replace test API credentials with your live production keys. Click Save changes to apply all settings. The payment gateway is now active and ready to process real customer transactions on your store.

Always perform a final test transaction in live mode with a small amount to confirm everything works correctly.

Common Issues & Troubleshooting

Payment gateway not appearing at checkout

Verify the gateway is Enabled in WooCommerce Settings > Payments and check that your store's currency is supported by the payment processor. Also ensure no plugin conflicts are disabling the gateway.

API key errors or connection failures

Double-check that API credentials are entered correctly without extra spaces. Verify you're using the correct keys for your environment (test vs live). Contact your payment processor to confirm your merchant account is active and properly configured.

Transactions failing or being declined

Check that your SSL certificate is properly installed and working. Verify your payment processor account is in good standing and has no holds. Review transaction logs in both WooCommerce and your payment processor dashboard for specific error messages.

Order status not updating after payment

Configure Webhook URLs in your payment processor account pointing to your WooCommerce site. Ensure your site can receive POST requests from the payment processor and check that firewall settings aren't blocking webhook notifications.

Prices mentioned in this guide are pulled from current plan data and may change. Always verify on the official WooCommerce website before purchasing.

Visit WooCommerce View WooCommerce Pricing