Plugins Plugin hub Backup SEO Caching Security Forms WooCommerce Images Best backup plugins
Hosting Hosting directory Shared Managed Cloud India
Themes & builders Compare Rank Math vs Yoast
Tools All tools Hosting finder Plugin stack builder Cost calculator Salt generator Theme detector Who is hosting this? Speed test Headline analyzer robots.txt generator Redirect generator Uptime calculator Blog name generator
Best lists Best backup plugins Deals
Guides All guides Speed up WordPress Choose hosting Back up WordPress
How we test

WooCommerce · Guide

How to Set Up PayPal in WooCommerce

How to Set Up PayPal in WooCommerce

Short answer

To set up PayPal in WooCommerce, install the free WooCommerce PayPal Payments plugin, then run the onboarding wizard to connect a PayPal Business account. You need WordPress 6.5 or newer, WooCommerce 9.6 or newer, and PHP 7.4 or newer, and you should test in sandbox mode before going live.

Key takeaways

  • PayPal Payments needs WordPress 6.5, WooCommerce 9.6, and PHP 7.4 or newer.
  • A Business account is required for card fields, Apple Pay, Google Pay, Fastlane, and Vaulting.
  • PayPal Checkout costs 3.49% plus a $0.49 fixed fee on domestic United States transactions.
  • International commercial transactions add 1.50% to the standard rate.
  • Sandbox testing uses a PayPal Sandbox account from the Developer Dashboard.
  • PayPal Subscriptions needs the WooCommerce Subscriptions extension and a linked PayPal plan.

What do you need before you set up PayPal in WooCommerce?

You need a PayPal Business account, WordPress 6.5 or newer, WooCommerce 9.6 or newer, and PHP 7.4 or newer.

The PayPal Payments startup guide lists these as the requirements for the WooCommerce PayPal Payments plugin (checked November 2026). A Business account is recommended, and it is required for card fields, Apple Pay, Google Pay, Fastlane, Vaulting, and Pay upon Invoice. Personal seller accounts work only in some regions and cannot use those features.

Set up the PayPal account before you start the plugin setup, or create one during onboarding. Link a bank account or card to the PayPal account and verify it, or PayPal will limit what you can receive.

If you already take card payments through another gateway, keep that gateway live until PayPal is tested, so checkout never goes dark.

WooCommerce itself is free and open source. Its WordPress.org plugin page lists PHP 7.4 or greater as the minimum requirement (checked November 2026).

How do you install WooCommerce PayPal Payments?

Install the free WooCommerce PayPal Payments plugin from Plugins > Add New, then activate it.

Search for “WooCommerce PayPal Payments” in the plugin search box, and install the result published by PayPal. The PayPal Payments startup guide gives these steps: install, click Activate, and follow the notice that links to the Account Setup page (checked November 2026). Do not use the old PayPal Standard or PayPal Checkout gateways, because PayPal Payments is the supported extension now.

If your store still runs an old PayPal gateway, disable it after PayPal Payments is live. Two PayPal options at checkout confuse shoppers and can split your payment records. Check WooCommerce > Settings > Payments after install to confirm only one PayPal method is enabled.

How do you connect your PayPal account?

Connect your account through the onboarding wizard, which runs in four steps: store type, product types, checkout options, and connecting the PayPal account.

The PayPal Payments onboarding docs describe the wizard: click Activate PayPal Payments on the Welcome page, work through the four steps, then click Connect to PayPal and log in to your PayPal account in the pop-up window (checked November 2026). Allow pop-ups for your site first, or the PayPal window will not open. Keep the browser tab open until the window closes and the plugin shows the Overview tab.

The wizard sets up the connection for you, so you do not need to paste API keys by hand. Manual connection with a Client ID and Secret Key is still possible from the advanced options, but most stores should use the wizard. If the connection fails, check that you logged in to the right PayPal account, and that the account country matches your store country.

Which PayPal payment options can you offer at checkout?

PayPal Payments can offer PayPal Checkout, guest checkout, card fields, Apple Pay, Google Pay, Venmo, Pay Later, and Fastlane.

The exact options depend on your account type and country. Card fields, Apple Pay, Google Pay, Fastlane, Vaulting, and Pay upon Invoice need a Business account.

The PayPal Payments onboarding docs state that a Business account is required for these features (checked November 2026). Venmo and Pay Later appear only where PayPal supports them for your region.

Pick the options your buyers use and turn the rest off. Each extra button adds load time and choice to the checkout page, and a shopper who sees six payment buttons can stall.

Show PayPal and cards first, then add wallets or Pay Later only when your buyers ask for them. For the page these buttons sit on, see how to customize the WooCommerce checkout.

Payment optionNeeds Business accountNotes
PayPal CheckoutNo, but recommendedBuyer pays from a PayPal balance or linked funding source
Guest checkoutNoBuyer pays by card without a PayPal account
Card fieldsYesCards are entered on your checkout page
Apple Pay and Google PayYesWallets shown where the buyer device supports them
VenmoYesUnited States buyers only
Pay LaterYesPayPal splits the order into later payments

What fees does PayPal charge on WooCommerce orders?

PayPal Checkout and guest checkout cost 3.49% plus a fixed fee on domestic United States transactions, and the fixed fee is $0.49 in USD.

PayPal's merchant fees page lists PayPal Checkout at 3.49% plus the fixed fee, standard card payments at 2.99% plus the fixed fee, and Pay Later at 4.99% plus the fixed fee (checked November 2026). International commercial transactions add 1.50% on top. The fixed fee for USD is $0.49.

Work the fee into your prices before you launch. A $50 order through PayPal Checkout costs $1.75 in percentage fees plus $0.49, which is $2.24 in total.

The same order through standard card fields costs $1.50 plus $0.49, which is $1.99. Compare that with the card rate on your other gateway in WooCommerce payment gateway fees compared before you pick a default. PayPal charges no monthly fee for the plugin itself, so the cost is per transaction.

How do you test PayPal payments in sandbox mode?

Test in sandbox mode with a PayPal Sandbox account from the PayPal Developer Dashboard, so no real money moves.

The PayPal Payments startup guide explains that you can enable Sandbox Mode from the advanced options and connect with the onboarding wizard or with a Client ID and Secret Key from a PayPal Sandbox REST application (checked November 2026). Create the sandbox account at developer.paypal.com under Dashboard, then Sandbox Accounts, then Create Account.

Place test orders for each payment option you offer, including a guest checkout and a card payment. Confirm the order appears in WooCommerce with the right total, then refund the test order from the PayPal sandbox.

Turn sandbox mode off before you go live, and place one small real order to confirm live payments work. A store left in sandbox mode takes no real payments at all.

How does PayPal work with WooCommerce Subscriptions?

PayPal Payments supports subscriptions in two ways: PayPal Subscriptions and PayPal Vaulting with Reference Transactions.

The PayPal Payments subscriptions docs state that the WooCommerce Subscriptions extension is required for both methods (checked November 2026). With PayPal Subscriptions, you activate the feature in the plugin settings, create a subscription product, and link it to a PayPal plan with a plan name. The billing cycle cannot be changed once the product is linked to PayPal, so set the price and period with care.

Vaulting stores the customer PayPal account for future charges when the Save PayPal and Venmo option is checked. Since PayPal Payments version 2.3.0, subscription payments use the Intent setting you configured. Pick one method per product and test a renewal before you sell it, because a subscription that cannot renew will fail quietly until the customer complains.

What should you check when a PayPal payment fails?

Check the plugin connection, the account type, and the order status in WooCommerce before you change any settings.

Start in WooCommerce > Settings > Payments and open the PayPal settings to confirm the account is still connected. A disconnected account is the most common cause of a sudden failure.

Then check that the buyer used a payment option your account supports, since a Personal account cannot take card fields, Apple Pay, or Google Pay. Read the order notes in WooCommerce for the error PayPal returned, and match it against the plugin troubleshooting docs.

Keep your plugin and WooCommerce versions current, because PayPal changes its API and old plugin versions stop working. PayPal also needs HTTPS on the whole checkout, and a mixed-content warning can block the payment window.

For the wider checkout checks, see is WooCommerce PCI compliant.

If you want a second gateway as a backup, compare the options in WooPayments vs Stripe. A second live gateway keeps checkout open while you fix the PayPal issue.

Frequently asked questions

Does PayPal charge a monthly fee in WooCommerce?

No, the WooCommerce PayPal Payments plugin is free to install, and PayPal charges no monthly fee for it. You pay per transaction instead: PayPal Checkout costs 3.49% plus a $0.49 fixed fee on domestic United States transactions, and card payments cost 2.99% plus the fixed fee.

Can customers pay without a PayPal account?

Yes, shoppers can pay by card without a PayPal account through guest checkout, as long as you enable it. Card fields also let buyers enter card details on your checkout page, but that option needs a PayPal Business account.

Should I keep the old PayPal Standard gateway too?

The old PayPal Standard and PayPal Checkout gateways are no longer the supported route. PayPal Payments replaces them, so disable the old gateways after PayPal Payments is live to avoid two PayPal buttons at checkout.

Why did PayPal payments suddenly stop working?

First confirm the plugin is still connected in WooCommerce > Settings > Payments. Then check that the buyer used an option your account type supports, and read the order notes for the error PayPal returned. A disconnected account is the most common cause.

Can I take subscription payments through PayPal?

Yes, but it needs the WooCommerce Subscriptions extension, and you must pick either PayPal Subscriptions or PayPal Vaulting. Set the price and billing cycle with care, because the cycle cannot be changed once the product is linked to a PayPal plan.

Sources

  1. PayPal Payments: Startup Guide WooCommerce
  2. Account Setup and Onboarding WooCommerce
  3. Subscriptions (PayPal Payments) WooCommerce
  4. Fees: Merchant and Business, PayPal US PayPal
  5. PayPal Developer Dashboard PayPal Developer
  6. WooCommerce – WordPress plugin WordPress.org

Is your product missing, or something out of date?

Tell us what to add or correct. We read every note and reply when we need a source. A message does not buy a ranking.

About the editors

WPLegible editors

Researched from the primary sources listed above and checked against our editorial rules. About the site · How we test