Checkout with Paddle for WooCommerce
Docs for Checkout with Paddle for WooCommerce.
Coding standards and releases
Coding standards and the release checklist.
Known limitations
What the plugin deliberately does not do, and why.
Licensing and the Lite upgrade
The license client, updates, and how Pro takes over from the free version.
Endpoints and front end
AJAX, admin-post and query endpoints, and the checkout scripts.
Local development and testing
Sandbox, tunnels for webhooks, logging, simulated webhooks and mocks.
Data reference
Order, subscription and user meta, options, transients, scheduled actions and uninstall.
Hooks reference
Filters and actions the plugin provides, with examples, and the hooks it uses.
Customer invoice links
How invoice and receipt links are added to pages and emails.
Refund internals
How refunds travel between WooCommerce and Paddle, and how chargebacks are handled.
Subscription internals
Linking, status mapping, renewal orders, the delayed link check and restrictions.
Webhooks
The endpoint, signature checks, Billing events, Classic alerts and multi-store tagging.
Concurrency and idempotency
Locks, fresh reads, markers, order completion, renewals and the refund ledger.
Architecture
Design principles, compatibility, files, boot sequence, drivers, API clients, gateway and blocks.
Settings storage
The settings option, every key, and the helpers to read them.
Checkout flow
Order lines, the three checkout entry points, subscriptions, Billing transactions, Classic pay links and payment confirmation.
Developer guide
Architecture, checkout and webhook flows, stored data, safety mechanisms, hooks and local testing.
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.
Checkout problems
“Checkouts are failing”, “Something went wrong starting the payment” and a missing Paddle option.
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.
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.