User guide
Setting up and running a WooCommerce store with Paddle.
Upgrading from the free version
Install Pro over the free version: nothing to migrate, and what Pro does on activation.
Switching from another Paddle plugin
Move to this plugin from another Paddle gateway for WooCommerce.
Frequently asked questions
Quick answers about WooCommerce Subscriptions, products, payment methods, checkout pages and more.
License, updates and upgrades
Activate your license, move from the free version, or switch from another Paddle plugin.
Your license key and updates
Activate your license for updates and support, and move it between sites.
Test connection errors
What each Test connection message means and how to fix it.
Refunds, renewals and webhooks
Refunds that don’t show up, renewals that don’t arrive, and duplicate webhooks.
Troubleshooting
Fixes for pending orders, checkout errors, connection tests, refunds and renewals.
Orders stay pending after payment
What to check when Paddle took the payment but the order is still Pending payment.
Checkout problems
“Checkouts are failing”, “Something went wrong starting the payment” and a missing Paddle option.
Several stores on one Paddle account
Run more than one WooCommerce store on the same Paddle account safely.
Going live checklist
Eight checks to move from sandbox testing to real payments.
The order screen
The Paddle box on orders and subscriptions: links, totals, earnings and a payment check.
The WooCommerce → Paddle page
The setup checklist, license box, 30-day stats and help tab.
Taxes and currencies
How Paddle handles sales tax and VAT, and which currencies each platform supports.
Invoices and receipts
Where customers find Paddle’s invoice or receipt for each order.
Refunds and chargebacks
Refund via Paddle, refund manually, refunds made in Paddle, and disputes.
Managing your store
Day-to-day use: the checkout, subscriptions, invoices, refunds, the order screen and taxes.
What your customers see
The checkout and the Pay for order page from your customer’s side.
Subscriptions
Selling WooCommerce Subscriptions through Paddle: what is supported and how changes sync both ways.
General and Paddle account
Enable Paddle, the title and description buyers see, account type, sandbox and credentials.
Checkout settings
Checkout style, theme, language, icons, images and tax options.
Subscriptions, refunds and advanced
Cancellation timing, customer links, debug logging and uninstall clean-up.
Webhook alerts
Turn on the Paddle Classic alerts that subscriptions, refunds and disputes need.
Settings reference
Every option on the Paddle payment settings screen, with its default and what it does.
Test the connection
Check that your saved Paddle Billing credentials work.
Set up Paddle Classic
Connect an older Paddle Classic account with your Vendor ID, API Auth Code and public key.
Vendor ID, Auth Code and public key
Copy your Paddle Classic credentials into WooCommerce and test them.
Set up the webhook
Let Paddle notify your store about payments, renewals and refunds, in one click or by hand.
Approve your website and payment link
Approve your domain in Paddle and set the default payment link to your checkout page.