What PayPal Adds to WooCommerce
A WooCommerce PayPal integration lets your WordPress store accept payments through PayPal, one of the most recognised payment names on the web. For a large number of shoppers, seeing the PayPal button at a checkout is reassuring: they can pay with an account they already trust, often without typing a card number, and they know PayPal stands behind the transaction. Adding it to your store means meeting those customers with the method they reach for by default, which for some buyers is the difference between finishing a purchase and closing the tab.
It is worth being clear about the roles. WooCommerce runs your store, your products, cart, and orders. PayPal is the payment service that collects the money and moves it to you. The integration connects the two so that when a customer chooses PayPal at checkout, the payment is handled by PayPal and the result is reported back to your store, which marks the order paid. Modern PayPal for WooCommerce also accepts ordinary credit and debit cards through PayPal, so it can serve both the PayPal loyal and card paying customers from a single setup.
There is another reason PayPal pulls in sales that is easy to underestimate. A meaningful share of online shoppers keep their money in a PayPal balance or have a card linked there rather than to hand, and for them the PayPal button is simply the path of least resistance. Offer it and they buy in seconds; leave it out and some of them go looking for the product somewhere that does offer it. PayPal also presents pay later options to eligible buyers in some markets, letting a customer split a purchase into instalments, which can nudge a hesitant shopper on a larger basket. You do not have to build any of that yourself, since the modern plugin surfaces the relevant options to each visitor automatically.
This guide covers the whole picture in plain terms: the PayPal options available for WooCommerce and which to choose, what to prepare, installing and connecting your business account, testing safely in the sandbox, the smart buttons and express checkout that speed people through, webhooks, currencies, fees, disputes and buyer protection, common problems, and how PayPal compares with a card first gateway. If you would rather have it set up and tested for you, you can get a free quote and we will handle it.
The PayPal Options for WooCommerce
One thing that confuses store owners is that PayPal for WooCommerce has come in a few forms over the years, and older guides mention names that no longer reflect the current, recommended way to do it. Let us clear that up.
The modern PayPal Payments plugin
The current, recommended integration is the official PayPal Payments plugin for WooCommerce. It is the one to use for a new setup. It presents the PayPal button and can also accept credit and debit cards through PayPal, it supports the smart payment buttons and express checkout that let people pay quickly, and it is kept up to date to work with current browser and security rules. If you are starting fresh, this is the plugin to install, and the rest of this guide assumes it.
The older standard and express methods
Older stores may still run legacy PayPal methods, sometimes called standard or express checkout, which worked by sending the customer over to PayPal's site to pay and then back to your store. These still function on some sites but are the old way, and they lack the smoother button experience and some of the newer capabilities. If your store is on one of these, moving to the modern PayPal Payments plugin is usually worth it, though it is a change to your checkout and should be tested carefully before going live.
Where PayPal fits alongside cards
PayPal does not have to be your only payment method, and for most stores it should not be. A common, sensible setup is to offer a card first gateway together with PayPal, so customers can pay whichever way they prefer. Our WooCommerce Stripe integration guide covers the card side, and running the two together tends to capture more sales than either alone. Our overview of WooCommerce payment gateways puts the whole set in context.
Before You Start
Getting a few things ready first makes the setup quick and avoids stopping halfway. Before installing anything, line up the following.
- A working WooCommerce store. Products, currency, and basic checkout should already be in place. If you are still building, our how to build a WooCommerce store guide covers the foundations and the wider WordPress ecommerce guide fills in the rest.
- A PayPal business account. You need a business account, not a personal one, so PayPal knows it is dealing with a seller and can enable the seller features and reporting. If you only have a personal account, you can upgrade it or open a business one, providing the business and bank details PayPal asks for.
- HTTPS across the site. A secure connection is required for taking payments. Your checkout must load over HTTPS with a valid certificate, which most hosts provide free.
- A backup, and ideally a staging site. Changing your checkout on a live store carries risk, so take a backup first and, for a busy store, test on a staging site before touching the live one.
With those ready, the setup is mostly following steps in order and then testing thoroughly. The testing stage is where you earn confidence that a real customer will get through cleanly, so do not skip it however keen you are to go live.
Installing PayPal Payments
The official PayPal Payments plugin installs like any other WooCommerce extension. From your WordPress dashboard, open the plugins area, choose to add a new plugin, and search for the official PayPal Payments gateway for WooCommerce. Make sure you pick the official one, published by the recognised author with a large install base and recent updates, rather than an unofficial lookalike, then install and activate it.
Once active, the plugin adds a PayPal section within the WooCommerce payments settings. That is where the whole configuration lives: connecting your business account, choosing whether to accept cards through PayPal as well as the PayPal button, where the buttons appear, and the smaller options. A standard setup needs no code at all. Everything happens through these settings, which is why the official plugin is the right starting point rather than a hand built integration for most stores.
As with any payment code, stick to the official plugin or a well known, actively maintained alternative. An abandoned or obscure plugin sitting around your checkout is both a reliability and a security risk. If you want to see how PayPal sits among the other tools a store uses, our roundup of the best WordPress ecommerce plugins is a useful companion, and the general how to add a payment gateway in WooCommerce guide explains the concept for any processor.
Before you configure anything, make sure WooCommerce itself is up to date, since payment plugins are built against current versions and an out of date store can cause odd conflicts. It is also wise to check that no old PayPal plugin from a previous attempt is still active, because two payment plugins trying to handle PayPal at once is a common cause of duplicated buttons and confusing behaviour. If you find a legacy one, deactivate it before setting up the modern plugin, and test carefully so you know which one is actually handling payments.
Connecting Your PayPal Business Account
With the plugin active, the next step is to link it to your PayPal business account. The modern plugin uses a guided connection: you click a connect or onboard button in the settings, get sent to PayPal to sign in and approve the link, and return to your store with the accounts joined. This is the simplest path because it wires up the credentials for you rather than making you copy technical values by hand, and it enables both the PayPal button and, where available, card acceptance through PayPal in one flow.
What this connection really does is authorise your store to create payments on your PayPal account and to receive updates back about them. Once linked, a customer choosing PayPal at your checkout has their payment processed against your account, and the money lands in your PayPal balance. If you run more than one store, connect each to the correct PayPal account, because a mix up sends money to the wrong place and creates a frustrating tangle to unwind.
After connecting, review the basic settings: whether to show the PayPal button on the cart and product pages as well as the checkout, whether to accept cards through PayPal, and how the payment appears to the customer. Getting these right up front, especially a clear business name on the charge, heads off the confusion and disputes that come from a buyer not recognising who took the payment.
It is also worth deciding early how PayPal captures the money. Most stores take payment immediately when the order is placed, which is the simplest and what customers expect. Some businesses, particularly those that make a product to order or ship after a delay, prefer to authorise the payment at checkout and capture it only when they are ready to fulfil. The plugin supports both patterns, and choosing the one that matches how you actually run orders avoids awkward situations like charging for something you cannot yet supply. If you are unsure, immediate capture is the sensible default for a normal retail store.
Testing in the Sandbox
PayPal provides a sandbox, which is a complete copy of the payment system where no real money moves, for testing your checkout before it goes live. This is the equivalent of a rehearsal, and it is the single most important habit in the whole process. In the sandbox you use special test accounts, a pretend buyer and a pretend seller, to run through purchases exactly as a real customer would, and confirm that everything behaves.
The plugin has a setting to switch between sandbox and live mode. Put it in sandbox, then run through several test purchases: a normal successful payment, and where you can, a cancelled or failed one so you see how your store handles a buyer who backs out. Check that orders are created, marked paid on success, that confirmation emails send, and that a cancelled payment returns the customer to your store gracefully without leaving a stuck order. Only when the sandbox behaves correctly should you switch to live mode.
Once live, do one small real purchase yourself to prove the whole chain works with real money: the payment succeeds, the order is marked paid, and the funds appear in your PayPal balance. This final live check catches the rare problems that only show up outside the sandbox, such as an account that is not fully ready to receive live payments. Skipping either the sandbox testing or the live check is how stores discover a broken checkout on their first real customer, which is the worst possible moment.
| Mode | What it uses | Money moves? | Use it for |
|---|---|---|---|
| Sandbox | PayPal test buyer and seller accounts | No | Rehearsing the whole flow safely |
| Live mode | Your real business account | Yes | Real customers, after sandbox passes |
| One live check | A real small purchase you make | Yes | Final proof before you announce it |
Smart Buttons and Express Checkout
One of the strongest features of modern PayPal for WooCommerce is the smart payment buttons and the express checkout they enable. Understanding these helps you place them where they do the most good.
Smart payment buttons
The smart buttons are the PayPal branded buttons that appear at your checkout and, if you choose, on the cart and even product pages. They are called smart because PayPal decides which options to show a given visitor, presenting the most relevant way for that person to pay. A recognisable button in the place a buyer expects it is reassuring and quick to use, and letting PayPal handle which options appear keeps the buttons current without you managing it.
Express checkout
Express checkout is the feature that lets a customer start paying with PayPal before filling in all the usual checkout fields. When someone taps the PayPal button on the cart or a product page, PayPal can supply their shipping and contact details from their account, so they skip much of the manual form filling. For a shopper on a phone, this can turn a fiddly multi field checkout into a few taps, which removes a lot of the friction that makes people abandon a purchase. Placing an express button on the cart page is one of the higher value things you can do to help mobile buyers finish.
Where to place the buttons
At a minimum, the buttons belong on the checkout. Adding them to the cart page enables express checkout for people ready to buy, and some stores add them to product pages for instant buying. The right amount depends on your store, but the general rule is to offer the quick path where a buyer is ready, without cluttering pages where they are still browsing. Test how the buttons look and behave on both desktop and phone, since the phone experience is where express checkout earns its keep.
Keeping the checkout uncluttered
A word of caution on placement: more buttons are not always better. A checkout crowded with every possible payment badge can look busy and even a little untrustworthy, which is the opposite of what you want at the moment of purchase. Aim for a clean layout where the PayPal button sits comfortably next to your card option, both clearly presented, with nothing fighting for attention. The goal is that whichever way a customer prefers to pay, they can see it at a glance and act without hesitation. If your checkout starts to feel cramped as you add methods, that is a sign to simplify the design rather than keep piling options on.
Webhooks and IPN
Behind the visible checkout, PayPal keeps your store informed through messages about what happened to each payment. Modern PayPal uses webhooks, and older setups used a similar mechanism called Instant Payment Notification, or IPN. Both do the same essential job: they tell your store when a payment succeeds, a refund is made, or a dispute is opened, so your orders stay accurate.
Why this matters is the same reason it matters with any gateway. Some events happen after the customer has left, or on PayPal's side entirely, such as a refund you issue from PayPal or a payment that is confirmed a moment later. Without these notifications reaching your store, orders can end up out of step with reality, sitting unpaid when they were paid, or missing a refund that was actually made. The webhook or IPN message is what keeps your store's records matching what truly happened.
The modern PayPal Payments plugin usually sets up its webhook automatically during the guided connection, so most people do not configure it by hand, but it is worth confirming it is working. If you ever move your site to a new domain, remember the notification address changes with it, and an old one pointing at the previous domain will quietly stop working, which leads to orders that never get marked paid. Broken notifications are behind a large share of the confusing order problems people run into, so checking they are healthy is time well spent.
Currencies and Cross Border Selling
PayPal supports many currencies, and it is used all over the world, which makes it a comfortable choice if you sell across borders. Your WooCommerce store has its base currency, set when you build it, and PayPal will charge customers in it. For a store selling mainly to one country, that is all you need to think about. For international selling, PayPal is a name buyers in many countries already recognise and trust, which can help conversions abroad where an unfamiliar local method might give a shopper pause.
If you want to present prices in different currencies for different regions, WooCommerce and add-ons can handle multi currency display, and PayPal can accept payment in a range of currencies. As with any store, keep the setup only as complex as your real needs, because every extra currency and rule is another thing to test and maintain. A common and sensible approach for a business starting to sell internationally is to keep one clear base currency and rely on PayPal's familiarity to reassure foreign buyers, then add complexity only when the sales justify it.
One point specific to PayPal and cross border selling is that receiving payments in a currency different from your account's main one can involve a currency conversion, and PayPal applies its own conversion when that happens. This is normal, but it is worth being aware of so the amount landing in your balance does not surprise you on international orders. Check the current terms for your country on PayPal's own site rather than relying on general figures.
If international sales become a real part of your business, it is worth planning the currency side deliberately rather than letting it happen by accident. Some sellers hold balances in more than one currency to avoid converting on every order, while others keep things simple with a single currency and accept the occasional conversion. There is no single right answer, only the one that fits your volume and your accounting. The key is to make the choice on purpose and to reconcile your PayPal records against your bookkeeping regularly, so the fees and conversions are accounted for rather than a mystery at the end of the month. A short conversation with your accountant about how you receive foreign payments usually pays for itself.
Fees and Payouts
Like every payment service, PayPal charges a fee on each transaction, typically a percentage of the sale plus a small fixed amount, and the exact rates depend on your country, the type of payment, and whether it is domestic or international. We will not quote numbers here, because they vary by market and change over time, and the accurate figure is always the current rate PayPal publishes for your region. You can check those directly with PayPal for your country.
The points to understand are qualitative. Card and account processing always has a cost, and that cost is a normal part of selling online, not something unique to PayPal. International payments and currency conversions can carry a little more, which is worth remembering if a lot of your sales come from abroad. And the amount that lands in your balance is the sale price minus the fee, so build the processing cost into your pricing as an ordinary expense rather than being caught out by the difference.
Payouts work a little differently from a pure card gateway. Money from a PayPal sale lands in your PayPal balance, and from there you transfer it to your bank, either on demand or on a schedule you set. There can be a short wait before funds are available to withdraw, especially early on with a new account, which is normal and not a sign anything is wrong. Knowing this rhythm saves the new store owner the worry of seeing a paid order but not yet the money in their bank. It is in the PayPal balance, on its way, working exactly as intended.
Disputes and Buyer Protection
PayPal is well known for its buyer protection, which is part of why shoppers trust it, and understanding how disputes work helps you sell with fewer headaches. A dispute happens when a buyer raises a problem with a payment through PayPal, perhaps because an item did not arrive or was not as described, or because they do not recognise the charge. PayPal has a structured process where the buyer opens a case, you get the chance to respond with your side and any evidence, and PayPal decides the outcome. For serious cases it can escalate to a claim.
The buyer protection that makes customers comfortable is the flip side of the seller's responsibility to fulfil orders well and keep records. The best way to keep disputes rare is to describe products honestly, ship promptly and keep proof of delivery, use a clear business name on the charge so buyers recognise it, and answer questions quickly so a confused customer contacts you rather than opening a case. When a dispute does come, respond within PayPal's timeframe with clear evidence, since ignoring it usually means losing by default.
There is also seller protection on PayPal's side for eligible transactions, which can cover you in certain situations if you have followed the rules, such as shipping to the confirmed address and keeping records. It does not cover everything, so it is not a reason to be careless, but it is a genuine safeguard for a seller who does things properly. Treat the occasional dispute as a normal cost of selling online rather than a crisis, and handle each one calmly with good records, which is what usually wins them.
It also helps to know the difference between a dispute raised through PayPal and a chargeback raised through the buyer's card provider. When someone pays by card through PayPal and then contacts their bank instead of PayPal, the case follows the card network's chargeback process, which is slower and has its own evidence requirements. PayPal will guide you through responding, but the timelines are set by the card networks, not PayPal. The practical lesson is the same either way: good records, honest descriptions, and prompt shipping are what protect you, and they matter more than any single setting in the plugin.
Finally, keep an eye on your account standing over time. A store that racks up many disputes can face closer review from PayPal, while a store with a clean record and quick, fair handling of the rare case tends to have an easy relationship with them. In other words, good customer service is also good payment hygiene. The same habits that keep buyers happy, clear communication and reliable fulfilment, are the ones that keep your payment account healthy.
Troubleshooting Common Problems
A clean PayPal setup still throws the occasional issue, and most fall into a few familiar groups.
The PayPal button does not appear
Usually this means the gateway is not enabled, the account connection did not complete, or the store is not on HTTPS. Confirm PayPal is enabled in the payments settings, that the guided connection finished successfully, and that your checkout loads securely. A currency your account cannot accept can also hide the button.
Payments work in sandbox but fail live
Check that you actually switched from sandbox to live mode, that your business account is fully set up to receive live payments, and that any required verification with PayPal is complete. A store left in sandbox will never take a real payment, and an account that is not ready can block live charges.
Orders stuck as pending or on hold
This is often a notification problem, the webhook or IPN not reaching your store, so the paid status never gets set even though the money moved. Confirm the notification is configured and pointing at your current domain. Some PayPal payments can also be genuinely pending on PayPal's side for review, in which case the order correctly waits until PayPal clears it, so check the payment status in your PayPal account too.
Customer paid but no order was created
This unsettling case usually traces back to the customer closing the window before being returned to your store, combined with a notification not arriving to record the payment. A healthy webhook setup is what prevents it, because the payment gets recorded even if the buyer does not make it back. If it happens, you can find the payment in your PayPal account and match it to the customer to sort it out.
Duplicate or double payments
Rare, but usually caused by a customer clicking twice or refreshing during payment. Good gateway setups guard against this, and you can refund a genuine duplicate easily from the order screen. If it happens repeatedly, it is worth having a developer look, since a checkout should not allow it.
When a problem outlasts these checks, both the plugin and PayPal keep logs of each attempt, and that is where a developer will look to find the true cause. A broken checkout costs sales every hour, so there is no virtue in struggling alone with it for days.
PayPal vs Card Gateways
A question that comes up constantly is whether to use PayPal or a card first gateway like Stripe, and the honest answer for most stores is both. They serve overlapping but different customers, and offering the two together captures more sales than either alone. Here is how they compare in the ways that matter.
| Aspect | PayPal | Card first gateway |
|---|---|---|
| Trust factor | A name many buyers already trust and look for | Feels native to your own checkout |
| Experience | Fast for account holders, express checkout on phones | Customer stays on your pages the whole time |
| Cards | Can accept cards through PayPal too | Cards are the core method |
| Buyer protection | Well known buyer protection reassures shoppers | Standard card dispute process |
| Best role | An option alongside cards, never usually alone | The default card path for everyone |
The pattern most successful stores land on is a card gateway as the default, so every visitor can pay by card on your own checkout, with PayPal offered alongside for the many people who prefer it. Some shoppers will only buy if PayPal is there, and others never touch it, so having both removes the reason to abandon that comes from a missing preferred method. Our WooCommerce Stripe integration guide covers setting up the card side to run next to PayPal.
PayPal Setup Checklist
Here is the whole process as a checklist to work through in order. Tick each one and you will have a PayPal checkout you can rely on.
| Step | What to confirm |
|---|---|
| HTTPS | The whole site loads securely with a valid certificate |
| Business account | A PayPal business account, not personal, is ready |
| Plugin | The official PayPal Payments plugin is installed and active |
| Connection | The store is linked to the correct PayPal business account |
| Buttons | Smart buttons placed on checkout, and cart for express |
| Sandbox | Test purchases succeed and cancellations are handled |
| Notifications | Webhook or IPN is set and pointing at your current domain |
| Live check | One real small purchase confirms money reaches your account |
| Cards | Decide whether to accept cards through PayPal too |
The two steps people skip most are thorough sandbox testing and confirming the notification setup, and those are exactly the two behind most later trouble, so give them proper attention before you rely on the checkout. Run through the list slowly the first time, and keep it handy for the next store you set up, since the same order of steps works every time.
When to Get Help
Many store owners set up PayPal themselves by following the steps, and for a straightforward store that is achievable. But the checkout is where mistakes cost the most, since a failed payment is a lost sale and a rattled customer. If you are running PayPal alongside a card gateway, moving off an old PayPal method, selling in several currencies, or you simply want to know it is done right and tested, bringing in someone who does this daily is a sensible investment rather than an indulgence.
We build and fix WooCommerce stores and their payments. We can install and connect PayPal, place the buttons where they help most, enable express checkout for phone buyers, test every path in the sandbox and with a live check, confirm the notifications keep orders in step, and set PayPal up to run cleanly alongside a card gateway so no ready buyer leaves for want of their preferred method. Because we are developers, we can also handle the custom cases and untangle the confusing order and notification problems that stump most people. You can see the full range on our services page.
If you want your payments set up properly and tested end to end, you can get a free quote and we will handle it and confirm it works before you depend on it. Or book a free consultation and we will talk through what your store needs with no pressure. A checkout you can trust is worth getting right the first time, and the first step costs nothing.