Paddle checkout for one-time Easy Digital Downloads sales.
Downloads, prices, and discount codes stay in Easy Digital Downloads. This checkout is for one-time sales and does not work with EDD Recurring. Recurring payments are a separate later release.
- Digital downloads and software
- One-time payments
- Sandbox, then live
- 1
The order exists before payment
Easy Digital Downloads records the order before Paddle is called.
- 2
Paddle takes the payment
Inline checkout is the default. Overlay is the other mode. Both sit on the payment page.
Files follow a confirmed payment
The order is completed once, after the server accepts the Paddle transaction. That completion delivers files and can issue Software Licensing keys.
- Paddle Billing
- Easy Digital Downloads
- One-time payments
- Sandbox and live
- Signed webhooks
The Easy Digital Downloads order is the charge.
The charge is built from the saved order. A Paddle product is not created. Quantities, discount codes, and fees come from that order. Tax in Easy Digital Downloads stays off the amount sent to Paddle.
The order, as the store priced it
- Downloads and quantities
- Discount codes and fees
- The order total before Paddle is called
Builds the Paddle transaction
- Items from the saved order
- A Paddle product is not created
- Store tax stays off the amount sent to Paddle
Payment, then the files
- The buyer pays in Paddle Checkout
- The order is completed once, after the server checks the transaction
- Files are delivered, and Software Licensing can issue a key
Leave tax off in Easy Digital Downloads.
Leave tax off in Easy Digital Downloads. Paddle calculates tax inside the total, under your agreement with Paddle. The default tax category is digital goods.
- Merchant of RecordPaddle calculates, collects, and remits the sales tax and VAT on the transaction, under your agreement with Paddle.
- Prices stay in Easy Digital DownloadsDownloads, files, and discount codes stay in Easy Digital Downloads. The charge is built from the saved order. A matching product is not created in Paddle.
- Digital goodsThe default tax category is digital goods, which matches software, files, and other downloads.
- 1
Easy Digital Downloads prices the order
Tax in Easy Digital Downloads stays off. The order total is the amount sent to Paddle.
- 2
Paddle calculates tax inside that total
Paddle takes the tax it is responsible for out of the amount the buyer agreed to.
The default category is digital goods
That category matches software, files, and other downloads.
Inline checkout is the default. Overlay is the other mode.
The buyer can start from the Easy Digital Downloads shortcode checkout, the Checkout block, or Buy Now. Paddle Checkout then opens on the payment page, inline or as an overlay. Paddle can use a one-page or a multi-page layout. The frame is Paddle’s.
-
Inline
The default. Paddle Checkout sits in the payment page.
-
Overlay
Paddle Checkout opens over the payment page. The buyer stays on the site.
Paddle’s payment methods and currencies.
-
Methods enabled on the Paddle account
Paddle shows the methods enabled on the account for that buyer’s country, currency, and device. A non-empty allow list in the gateway settings can narrow that set. This gateway does not add methods of its own.
-
The store currency has to be one Paddle can charge
An unsupported store currency is refused before a transaction is created.
The order is completed only after Paddle confirms the payment.
- Every payment is confirmed with PaddleA message from the browser is not enough. ALGRA looks the transaction up with Paddle before the order is completed.
- Amount and currency must matchAnother currency, or a total below the order, holds the order and keeps the files locked.
- One payment, one orderA Paddle payment already used for a completed order cannot complete another one.
- Signed notifications onlyWebhook signatures are checked against the raw request body. A repeated notification is ignored.
Refunds stay on the Easy Digital Downloads order.
- Refund the full amount or part of itA refund started on the Easy Digital Downloads order is sent to Paddle, for the full amount or part of it. Paddle reviews most live refunds before paying them out.
- Paddle-side refunds stay visibleRefunds started in Paddle are recorded on the Easy Digital Downloads order.
- The order stores the Paddle transactionThe order carries the Paddle transaction ID, and the Paddle transaction carries the order ID.
- Separate sandbox and liveSandbox and live use separate API keys, client-side tokens, and webhook secrets. Check the connection in the gateway settings before you switch to live.
Four steps once your Paddle account is ready.
You’ll need a Paddle account approved for your business. Everything below can be tested in sandbox first.
-
Create your keys
Create an API key and a client-side token for sandbox, and later for live, and paste them into the plugin settings.
Paddle → Developer tools → Authentication -
Set a default payment link
Paddle needs one before it creates transactions. It must be on a website Paddle has approved. Sandbox accepts localhost.
Paddle → Checkout → Checkout settings -
Add the webhook
Point a notification destination at the URL shown in the plugin settings, subscribe it to these events, and paste its secret:
transaction.completedtransaction.paidtransaction.payment_failedtransaction.canceledadjustment.createdadjustment.updated -
Test, then go live
Run test checkouts in sandbox. When Paddle has approved your live domain, add your live credentials and switch sandbox off.
Paddle → Checkout → Website approval
Turn on the payment methods you want in Paddle. This checkout is for one-time sales and does not work with EDD Recurring. Test in sandbox before you switch to live.
Built for one-time digital sales.
Great fit
- Plugins, themes, and downloadable software
- Ebooks and other digital files
- Software Licensing keys issued when the order is completed
- Stores that price downloads and discount codes in Easy Digital Downloads
Not a fit
- Physical products or anything shipped. Paddle’s policy does not allow them.
- Recurring subscriptions. WP Smart Pay already sells Paddle for Easy Digital Downloads, including subscriptions. This checkout takes one-time payments and does not work with EDD Recurring. Recurring payments are a separate later release.
- Products outside Paddle’s acceptable use policy.
What you need
Easy Digital Downloads
3.2+
Checkout block inner blocks need 3.7
WordPress
6.2+
The site Easy Digital Downloads runs on
PHP
8.0+
The version this gateway runs on
Paddle
Paddle Billing
API key and client-side token
Questions merchants ask
Does it work with EDD Recurring?
No. This checkout is for one-time EDD sales and does not work with EDD Recurring. Recurring payments are a separate later release.
Does it use Paddle Classic?
This checkout uses Paddle Billing. A Paddle Classic vendor id, auth code, or public key is not part of it.
Do I have to create products in Paddle?
No. The download stays in Easy Digital Downloads. The charge is built from the saved order. A matching product is not created in Paddle.
Can this move my existing Paddle subscriptions?
No. This checkout does not move existing Paddle subscriptions into Easy Digital Downloads.
Can I use this beside another gateway?
Easy Digital Downloads keeps its own list of enabled gateways. This one is for new one-time Paddle Billing sales.
What happens to orders already paid with another gateway?
Those orders stay as they are. New one-time checkouts can use this gateway. Nothing here rewrites the old orders.
Will Software Licensing still issue keys?
Yes. The order is marked complete once, after Paddle confirms the payment, which is when files are delivered and Software Licensing can issue a key.
How do refunds work?
Refund the full amount or part of it from the Easy Digital Downloads order and it is sent to Paddle. Refunds started in Paddle are recorded on the order. Paddle reviews most live refunds.
Who handles tax?
Leave tax off in Easy Digital Downloads. Paddle calculates tax inside the total.
Can I sell physical products?
No. Paddle's acceptable use policy does not allow physical products.
No questions match that search.
Other Paddle integrations
-
Paddle for WooCommerce
Use Paddle Billing for WooCommerce checkout and keep WooCommerce as your store and order system.
-
Paddle for LearnDash
Paddle Billing checkout for one signed-in LearnDash course or group.
-
Paddle for MemberPress
Paddle Billing checkout on the MemberPress registration form, for lifetime and recurring memberships.
-
Paddle for Paid Memberships Pro
Paddle checkout for Paid Memberships Pro. The level starts after Paddle confirms payment.
Keep Easy Digital Downloads as your store.
Paddle Billing takes the one-time payment. Downloads, prices, and discount codes stay in Easy Digital Downloads.
One-time payments · Files after a confirmed payment · Does not work with EDD Recurring