Paddle Billing × Easy Digital Downloads

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. 1

    The order exists before payment

    Easy Digital Downloads records the order before Paddle is called.

  2. 2

    Paddle takes the payment

    Inline checkout is the default. Overlay is the other mode. Both sit on the payment page.

  3. 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
How it works

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.

1 · Easy Digital Downloads

The order, as the store priced it

  • Downloads and quantities
  • Discount codes and fees
  • The order total before Paddle is called
2 · ALGRA

Builds the Paddle transaction

  • Items from the saved order
  • A Paddle product is not created
  • Store tax stays off the amount sent to Paddle
3 · Paddle Billing

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
Merchant of Record

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. 1

    Easy Digital Downloads prices the order

    Tax in Easy Digital Downloads stays off. The order total is the amount sent to Paddle.

  2. 2

    Paddle calculates tax inside that total

    Paddle takes the tax it is responsible for out of the amount the buyer agreed to.

  3. The default category is digital goods

    That category matches software, files, and other downloads.

Checkout

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.

Global checkout

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.

Payment safety

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.
Day to day

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.
Setup

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.

  1. 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
  2. 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
  3. 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
  4. 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.

Is it right for you?

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.
Requirements

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

FAQ

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.

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