Checkout with Paddle for EDD
Docs for Checkout with Paddle for Easy Digital Downloads.
Licensing and the Lite upgrade
The License class, its constants and statuses, and how Pro takes over from Lite.
Coding standards and releases
Coding standards and the release checklist.
Known limitations
What the plugin deliberately does not do, and why.
Endpoints and front end
AJAX and admin endpoints, and the checkout script’s data and behaviour.
Local development and testing
Sandbox, tunnels for webhooks, logging, simulating webhooks and mocking the API.
Hooks reference
Filters and actions the plugin provides, and the EDD hooks it uses.
Data reference
Order, subscription and customer meta, options and transients.
Concurrency and idempotency
Locks, fresh reads, markers, the renewal state machine and the refund ledger.
Refund internals
How refunds travel from EDD to Paddle and from Paddle to EDD.
Subscription internals
The Recurring_Gateway overrides, status mapping, and pause and resume.
Checkout flow
How a cart becomes Paddle lines, and the one-time, subscription, Billing and Classic checkout flows.
Webhooks
The endpoint, signature checks and how each Billing event and Classic alert is handled.
Architecture
Design principles, files, boot sequence, drivers and API clients.
Settings storage
Where settings live, every key, and the helpers to read them.
Switching from another Paddle plugin
Move to this plugin from another Paddle gateway for EDD.
Developer guide
Architecture, payment and webhook flows, stored data, safety mechanisms, hooks and local testing.
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.
Upgrading from the free version
Install Pro over Lite: nothing to migrate, and what Pro does on activation.
Test connection errors
What each Test connection message means and how to fix it.
Taxes, invoices and duplicate webhooks
Double tax, invoice links that are not ready yet, and webhooks that arrive twice.
Frequently asked questions
Quick answers about products, discounts, payment methods, EDD Pro, checkout pages and more.
Orders stay pending after payment
What to check when Paddle took the payment but the EDD order is still Pending.
Checkout problems
The “Checkouts are failing” warning, “Something went wrong” and a missing Paddle option.
Going live checklist
Seven checks to move from sandbox testing to real payments.
Troubleshooting
Fixes for pending orders, checkout errors, connection test messages and other common problems.
The order screen
The Paddle box on each EDD order: links, totals, invoices and a manual payment check.
Taxes and currencies
How Paddle handles sales tax and VAT, and which currencies each platform supports.
Several stores on one Paddle account
Run more than one EDD store on the same Paddle account safely.
Subscriptions
Selling EDD Recurring Payments subscriptions through Paddle: what is supported and how renewals, failures, pauses and cancellations sync.