A working WooCommerce PayPal setup lets customers pay with a PayPal balance, a card, or Pay Later options without leaving your checkout page. Most stores can have it live in under twenty minutes using PayPal’s own official plugin. This guide covers the setup, the settings worth changing from their defaults, and the mistakes that cause payments to fail at checkout.
Use the official plugin, not the legacy gateway
WooCommerce’s older built-in “PayPal Standard” method redirects customers away from your site and is no longer the recommended option. Use the PayPal Payments plugin, published by PayPal, which keeps customers on your checkout page.
What you need before you start
You need a PayPal Business account, which is free to open, and a live WooCommerce store with the WooCommerce plugin already active. If you only have a personal PayPal account, upgrade it to Business first from your PayPal account settings; a personal account cannot accept the full range of payment methods a store needs.
Have your business details ready, since PayPal will ask for them during the connection step: legal business name, website URL and a few basic compliance answers.
Step 1: Install the PayPal Payments plugin
In wp-admin go to Plugins → Add New Plugin, search for “PayPal Payments” and install the one published by PayPal. Alternatively, download it from the WordPress.org plugin page and upload it under Plugins → Add New Plugin → Upload Plugin. The plugin’s own documentation on woocommerce.com is worth bookmarking, since PayPal updates the connection flow from time to time.
Activate it. A new PayPal section appears under WooCommerce → Settings → Payments, alongside whatever other gateways your store already has configured.
Step 2: Connect your PayPal Business account
Open WooCommerce → Settings → Payments → PayPal and click Connect. This opens a PayPal login window where you sign in and grant the plugin permission to process payments on your store’s behalf. You do not need to copy any API keys by hand; the connection handles that for you.
Once connected, the plugin shows your account status and lets you toggle which payment options appear at checkout: PayPal button, Pay Later (where available), and card payments through PayPal’s own card processing.
Step 3: Set the checkout options that matter
| Setting | Recommendation |
|---|---|
| Smart Payment Buttons | Enable, so PayPal, Pay Later and card options appear as one block |
| Card processing | Enable if you want customers to pay by card without a PayPal account |
| Intent | “Capture” for most stores; “Authorize” only if you manually approve orders before charging |
| Button locations | Checkout page, cart page and optionally single product pages for faster buying |
Leave “Authorize” for capture intent unless you have a real reason to delay charging the card, since forgetting to capture an authorized payment within its window means the order is never actually paid.
Step 4: Test the checkout in sandbox mode
Before going live, switch on Sandbox mode in the plugin settings and connect a PayPal Developer sandbox account. Place a full test order, including a failed-payment attempt, to confirm order statuses update correctly in WooCommerce → Orders.
Turn sandbox mode off once you have confirmed a successful test order, and place one small real purchase yourself to see the full flow a customer will experience.
Common WooCommerce PayPal problems and fixes
- PayPal button does not appear at checkout: confirm the currency in WooCommerce → Settings → General is one PayPal supports for your account’s country, and that the connection status still shows “Connected”.
- Payment succeeds in PayPal but the WooCommerce order stays “Pending”: this is almost always a webhook problem. Reconnect the account from the plugin settings, which re-registers the webhook automatically.
- “This transaction cannot be processed” error: usually a mismatch between your store currency and the currency your PayPal account is set up to receive, or an unsupported customer country.
- Duplicate PayPal buttons or conflicting old settings: deactivate the legacy PayPal Standard gateway if it is still listed under Payments, since running both can double up buttons at checkout.
PayPal fees and payout timing
PayPal charges a percentage plus a fixed fee per transaction, and the exact rate depends on your country and whether the payment is domestic or international; check the current rate on your PayPal account’s fee page rather than relying on a number printed elsewhere, since these change from time to time. Funds usually arrive in your PayPal balance within minutes of a successful order, and you choose separately when to transfer that balance to your bank account.
Keeping WooCommerce PayPal payments secure
Only connect through the official plugin’s OAuth flow rather than pasting API credentials from an email or a third party. Keep WooCommerce, WordPress and the PayPal Payments plugin updated, since checkout code is one of the most targeted parts of any store. If you are also setting up card payments directly, confirm your site runs HTTPS everywhere, which the plugin requires before it will process live transactions.
If order emails from WooCommerce, including PayPal payment confirmations, are landing in spam instead of your customers’ inbox, that is a separate authentication issue covered in our WordPress not sending emails guide.
If the wider checkout is broken, not just PayPal
A PayPal-specific error is different from a checkout that fails for every payment method: a blank page after clicking “Place order”, a spinning button that never finishes, or a step that will not let the customer proceed past shipping. If that describes your store, work through our broader WooCommerce checkout not working guide first, since it covers plugin conflicts, caching and theme issues that sit underneath every gateway, PayPal included.
It is also worth testing PayPal alongside at least one other gateway, such as a card processor. If both fail in the same way, the problem is almost certainly in WooCommerce or your theme rather than in the PayPal connection itself.
Rather have it set up for you?
We build and fix WooCommerce stores, including payment gateway setup, from $700 for a new store or $45 for a fix on an existing one. Get your WooCommerce PayPal setup sorted.
WooCommerce PayPal setup: quick answers
Do I need a PayPal Business account for WooCommerce PayPal setup?
Yes. A personal PayPal account cannot connect to a store checkout in the way WooCommerce needs. Upgrading a personal account to Business inside PayPal is free and usually instant.
Can customers pay with a card without a PayPal account?
Yes, if you enable card processing in the plugin settings. PayPal then presents a card field directly at checkout so customers without a PayPal account can still pay.
Why is my WooCommerce PayPal order stuck on Pending payment?
This usually means the webhook that tells WooCommerce a payment succeeded never arrived. Reconnecting the PayPal account from the plugin settings re-registers the webhook and typically fixes it.
Is the free PayPal Payments plugin enough, or do I need a paid option?
The free official plugin covers PayPal, Pay Later and card payments for the large majority of stores. Paid third-party alternatives mainly add extra features like subscriptions billing or multi-vendor payouts that most single-store owners do not need.
