The main WooCommerce PayPal integration is the WooCommerce PayPal Payments plugin, made by PayPal. You install it in WordPress, click Activate PayPal Payments, log in to PayPal and click Connect to PayPal. Shoppers can then pay with PayPal, Pay Later, Venmo and cards, and you refund from the order in WooCommerce. Where it stops: a shopper can pay in PayPal with no WooCommerce order made, a restored backup can make payments fail, partial refunds don't change the order status, and nobody checks PayPal against your orders. AI agents do that work.
What a WooCommerce PayPal integration has to do
WooCommerce holds the order: what was bought, where it ships and how much stock is left. PayPal holds the money. If the two don't agree, you ship an order nobody paid for, or a shopper pays and no order shows up to pack.
So connected has to mean three things. Each PayPal payment makes one WooCommerce order with the right items. Each refund shows on the order. And when the two don't match, someone finds out the same day. The plugin does the first part well most days. The rest is where stores end up checking by hand.
Two ways to connect PayPal with WooCommerce
Most stores need only the first one. The second is for stores with a Braintree merchant account.
WooCommerce PayPal Payments
- How it works
- A plugin by PayPal. You install it from Plugins, then Add New, in WordPress. On its settings page you click Activate PayPal Payments, answer a few questions about what you sell, log in to PayPal and connect. It adds PayPal buttons, Pay Later, Venmo, card fields, Apple Pay and Google Pay to checkout.
- Good for
- Most WooCommerce stores that want PayPal at checkout. It needs WordPress 6.5 or newer and WooCommerce 9.6 or newer.
- Where it breaks
- WooCommerce's own guide says payments can fail with a DUPLICATE_INVOICE_ID error after you restore an old backup, or when two sites share an invoice prefix. In the plugin's WordPress.org forum, recent threads report shoppers paying in PayPal with no WooCommerce order made, and an order that kept two of six products after the shopper paid for all six.
PayPal Enterprise Payments (formerly Braintree)
- How it works
- A WooCommerce extension that takes cards, PayPal and Venmo through Braintree. You copy the Public Key, Private Key and Merchant ID from the Braintree Control Panel and paste them into WooCommerce, under Settings, then Payments.
- Good for
- Stores that already have a Braintree merchant account, or sell subscriptions and pre-orders and want both cards and PayPal in one place.
- Where it breaks
- Your store currency has to match your merchant account. WooCommerce's guide says a payment held for review or declined has to be sorted out in Braintree, not in the store. PayPal sends no cancel notice for billing agreements, so a shopper who cancels in PayPal still has an active subscription in WooCommerce.
Arkeo agents
- How it works
- Agents compare PayPal payments, refunds and fees to WooCommerce orders each day. They find payments with no order, orders with no payment and refunds the store doesn't show, follow up with shoppers whose payment failed, and gather the order and tracking proof when a dispute opens.
- Good for
- Stores that take PayPal orders all week, where a payment with no order means a customer waiting for something nobody is packing.
- Where it breaks
- Anything your rules keep for a person, like a large refund or an answer to an angry shopper, goes to the owner in one message.
How to connect PayPal with WooCommerce
These follow WooCommerce's PayPal Payments guides. Open them for the screens.
- 1Check your versions
Make sure your site runs WordPress 6.5 or newer and WooCommerce 9.6 or newer. Use a PayPal Business account if you can. WooCommerce's guide says it adds card payments, fraud tools and invoicing.
- 2Install the plugin
In WordPress, go to Plugins, then Add New. Search for WooCommerce PayPal Payments, find the one by PayPal, click Install Now and then Activate.
- 3Test with a sandbox account first
On the setup page, click See advanced options and turn on Sandbox Mode. Click Connect Account and log in with a PayPal sandbox account. Place a test order with a second sandbox buyer account.
- 4Connect your live PayPal account
Click Activate PayPal Payments. Say if you are a business or a person, tell it what you sell, and turn on the checkout features you want. Log in to PayPal and click Connect to PayPal.
- 5Give each site its own invoice prefix
The plugin sends each order number to PayPal with an invoice prefix. If two sites use one PayPal account, give each its own prefix, or PayPal can block payments as repeats.
- 6Test a refund
Open a test order under WooCommerce, then Orders, and refund part of it in the Order Items section. PayPal emails the buyer. WooCommerce only marks the order Refunded when the full amount is refunded.
Where the WooCommerce PayPal integration stops
The plugin takes the payment and writes it on the order. Making sure each payment and each order still match after that is a person's job.
A payment can arrive with no order. In a September 2026 thread in the plugin's WordPress.org forum, a store reported that shoppers approved PayPal payments but WooCommerce never made the order. The store turned PayPal off until it was sorted. In another thread, a shopper paid for six products, and the WooCommerce order kept only two of them and took only two out of stock.
An old backup can break checkout. WooCommerce's troubleshooting guide says the plugin sends each order number to PayPal. After you restore a backup, new orders can reuse numbers PayPal has already seen, and PayPal blocks them with a DUPLICATE_INVOICE_ID error.
Partial refunds are easy to miss. WooCommerce's guide says the order is only marked Refunded when the full amount goes back. A partial refund leaves the status as it was. In a forum thread, a store found that after a dispute closed in its favor, the PayPal rows on the order still counted the held money as refunded. They showed far more refunded than the store had paid back. The plugin's support team logged it for its developers.
Subscriptions can drift. With PayPal Enterprise Payments, PayPal sends no cancel notice for billing agreements, so WooCommerce can't cancel a subscription the shopper ended in PayPal.
And nothing compares PayPal's activity to your orders. Someone opens both, line by line, when the month's numbers don't add up.
The agents that do it
Each agent does one job from start to finish, in your own WooCommerce store and PayPal account. Your team talks to them in Slack or Teams.
Your store and PayPal agree.
- Compares PayPal payments to store ordersevery day
- Finds payments with no order, or refunds not in the storeper payment
- Sends each one to your team with the causeright away
Fewer sales lost to a failed card.
- Spots orders where payment failedas they happen
- Follows up with the shopper by emailsame day
- Reports what came backevery week
Stop losing disputes you could have won.
- Spots new disputesas they open
- Gathers the order and tracking proofsame day
- Sends the proof, or gives it to the owner to checkbefore the deadline
Questions
Is my customers' information safe?
Yes. Agents work in your own WooCommerce store and PayPal account and see only what their job needs. Customer details never go into public AI. Agents connect to AI through business-grade connections audited under SOC 2.
How do I connect PayPal with WooCommerce?
Install the WooCommerce PayPal Payments plugin from Plugins, then Add New, in WordPress and activate it. On its setup page, click Activate PayPal Payments, log in to PayPal and click Connect to PayPal.
Why did a PayPal payment go through with no WooCommerce order?
Stores in the plugin's forum have reported it, and the plugin's support team asks for the logs and order notes to find the cause. Until it is found, someone has to compare PayPal's activity to your orders by hand.
What is the DUPLICATE_INVOICE_ID error?
PayPal blocks a payment when it has already seen that invoice number. WooCommerce's guide says it can happen after you restore an old backup, or when two sites share one invoice prefix. Give each site its own prefix.
What does it cost?
You get the price on the call, along with the hours it saves your team.
Sources
- woocommerce.com: paypal payments startup guide
- woocommerce.com: troubleshooting
- woocommerce.com: managing orders and refunds
- woocommerce.com: woocommerce gateway paypal powered by braintree
- wordpress.org: paypal approved but woocommerce stops after ppc approve order
- wordpress.org: woocommerce issue with paypal orders
- wordpress.org: refund breakdown in order admin counts failed refunds e g dispute hold