Paddle checkout for WooCommerce, with no product syncing.
Keep your products, prices and coupons in WooCommerce. ALGRA sends each order to Paddle as it stands, and Paddle handles payment and tax as your Merchant of Record.
- For digital products and services
- One-time payments
- Test in Paddle sandbox first
- Paddle Billing
- Checkout block
- Classic checkout
- HPOS compatible
- Sandbox & live
One WooCommerce order becomes one Paddle transaction.
Instead of mirroring your catalog into Paddle, ALGRA builds each Paddle transaction from the order itself, using Paddle’s non-catalog items. Your Paddle product list stays empty, and there is nothing to map.
The order, as your store priced it
- Products and quantities
- Coupons and dynamic prices
- Shipping lines and fees
Builds the Paddle transaction
- One line per order line
- Single-line fallback so totals match to the cent
- WooCommerce tax left out, so Paddle doesn’t tax it again
Checkout, payment and tax
- Paddle takes payment as Merchant of Record
- Order is updated in WooCommerce
- Transaction ID on the order, order ID in Paddle
Sync-based Mirror the catalog
- Every product and price has a twin in Paddle to create and maintain
- Price changes, variations and sales need to reach Paddle too
- Coupons and custom totals need converting into Paddle discounts
Order-based · ALGRA Send the order
- No products to create in Paddle and no catalog to keep in sync
- Paddle is charged from each order, so there’s no second price list to go out of date
- Coupons, fees and pricing plugins work because Paddle gets the result
Paddle is the seller. WooCommerce stays the record.
With Paddle as Merchant of Record, Paddle is the seller on each transaction and calculates, collects and remits the sales tax and VAT due on it, under your agreement with Paddle. Your orders, customers and reporting stay in WooCommerce.
- Built so tax isn’t charged twiceWooCommerce tax and tax-named fees are left out of what Paddle charges, and prices are sent as tax-inclusive by default.
- The total at checkout is the total chargedWith WooCommerce tax turned off and the default “tax included” setting, customers pay exactly the total your checkout shows.
- The right Paddle tax categoryChoose from Paddle’s categories, such as SaaS, ebooks, digital goods or training services. Categories other than Standard need approval from Paddle.
- 1
Customer checks out in WooCommerce
Your products, prices, coupons and order number.
- 2
Paddle Checkout takes the payment
Paddle works out tax for the customer’s location and is the seller of record.
- 3
Paddle handles the tax obligations of the sale
Collection and remittance of sales tax and VAT, and the customer receipt.
The WooCommerce order is updated
Status, notes and the Paddle transaction ID, where you already work.
What Paddle is responsible for is set by your agreement with Paddle.
Five ways to present Paddle Checkout.
Paddle Checkout comes in two forms, inline and overlay. ALGRA gives you five ways to place them in your store, so you can keep customers on your checkout or give payment its own step.
Overlay on checkoutRecommended
Customers place the order as usual and Paddle opens over the checkout page. There is no extra page to load.
- When to use it
- A good default. WooCommerce validates and creates the order before Paddle opens, so required fields and terms are enforced first.
- Works with
- Checkout block: Yes Classic checkout: Via payment page
Embedded in the payment box
Paddle Checkout appears inside the payment method box once the billing details are filled in.
- When to use it
- For Checkout block stores with a standard set of fields that want the fewest clicks.
- Works with
- Checkout block: Yes Classic checkout: Not available
Payment is taken before WooCommerce places the order. Use an overlay mode if you add custom required checkout fields.
Payment page, embedded
After placing the order, customers land on a payment step on your site with Paddle Checkout embedded in the page.
- When to use it
- When your theme or page builder makes the checkout page hard to change, or you want a dedicated payment step.
- Works with
- Checkout block: Yes Classic checkout: Yes
Payment page, overlay
Customers land on a payment step on your site and Paddle opens as an overlay, with a "Pay now" button to reopen it.
- When to use it
- The simplest setup, and a fallback if other scripts on your checkout conflict with an embedded frame.
- Works with
- Checkout block: Yes Classic checkout: Yes
Your Paddle payment link
Customers are sent to the page you set as your default payment link in Paddle to complete payment.
- When to use it
- When you already run a payment page with Paddle.js and want payment to happen there.
- Works with
- Checkout block: Yes Classic checkout: Yes
That page must load Paddle.js and be on a Paddle-approved domain. Paddle opens checkout there from the transaction link.
| Experience | Paddle checkout | Checkout block | Classic checkout |
|---|---|---|---|
| Overlay on checkout | Overlay | Yes | Via payment page |
| Embedded in the payment box | Inline | Yes | No |
| Payment page, embedded | Inline | Yes | Yes |
| Payment page, overlay | Overlay | Yes | Yes |
| Your Paddle payment link | Set by that page | Yes | Yes |
Paddle’s payment methods and currencies, from your store.
-
Cards, wallets and local methods
Offer cards, PayPal, Apple Pay, Google Pay and local methods enabled on your Paddle account. Paddle shows each customer the options available for their country, currency and device.
-
30+ currencies
Works in the currencies Paddle supports. If your store currency isn’t one of them, the payment method hides itself and the settings screen tells you why.
-
Checkout in your site’s language
Paddle Checkout opens in your WordPress site language where Paddle supports it, and in English otherwise.
The reconciliation work you’d otherwise build yourself.
- Every payment is confirmed with PaddleWhen checkout reports a payment, ALGRA looks the transaction up with Paddle before the order is marked paid.
- Amount and currency must matchIf Paddle reports a payment in another currency or for less than the order needs, the order is held for review instead of being marked paid.
- One payment, one orderA Paddle payment already used for a paid order can’t be used to pay another one.
- Signed notifications onlyPaddle webhooks are signature-verified before any order is updated.
- Webhooks aren’t the only way an order gets marked paidWhen the customer returns to the order-received page, ALGRA checks the transaction with Paddle directly.
- 1
Browser: “payment complete”
Paddle Checkout returns a transaction reference.
- 2
ALGRA asks Paddle directly
The reference from the browser is never trusted on its own.
- 3
Checks against the order
StatusCurrencyAmountNot used elsewhere Order marked paid
With the Paddle transaction ID and a note on the order.
In parallel, signed Paddle webhooks update the same order. An order that is already paid isn’t marked paid again.
Run it like any other WooCommerce gateway.
- Refund from the order screenFull and partial refunds are sent to Paddle. Paddle reviews most live refunds before paying them out, and its decision lands in the order notes.
- Paddle-side refunds stay visibleRefunds made in the Paddle dashboard are recorded as notes on the WooCommerce order.
- Trace any payment from either sideEvery order carries its Paddle transaction ID, and Paddle transactions carry the WooCommerce order ID.
- Separate sandbox and liveSeparate keys, tokens and webhook secrets, and Paddle customer records are stored per environment.
- No extra librariesNo Composer dependencies. Paddle.js is only loaded where a customer pays with Paddle.
- 1
Refund in WooCommerce
Full or partial, with a reason, from the order screen.
- 2
Paddle refund adjustment created
The adjustment ID is added to the order notes.
- 3
Paddle reviews the refund
Pending approvalApprovedRejected Outcome noted on the order
Paddle’s decision arrives by webhook and is recorded on the order.
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 orders in sandbox. When Paddle has approved your live domain, add your live credentials and switch sandbox off.
Paddle → Checkout → Website approval
Also in Paddle: turn on the payment methods you want to offer, and request any tax category other than Standard.
Built for stores that sell digital products.
Great fit
- Plugins, themes and downloadable software
- Software licences and one-time SaaS purchases
- Ebooks and digital downloads
- Hosting, online training and professional services
- Stores that already run pricing, coupons and fees in WooCommerce
Not a fit
- Physical products or anything shipped. Paddle’s policy doesn’t allow them.
- Recurring subscriptions. ALGRA takes one-time payments and doesn’t work with WooCommerce Subscriptions.
- Products outside Paddle’s acceptable use policy.
What you need
Current version: 1.1.1.
WooCommerce
7.0+
Tested up to 10.3
WordPress
6.0+
Tested up to 7.0
PHP
8.0+
No Composer dependencies
Paddle
Paddle Billing
Sandbox or live account
Questions merchants ask
Do I have to create products in Paddle?
No. ALGRA sends each WooCommerce order to Paddle as non-catalog items, so there are no Paddle products or prices to set up, map or keep up to date.
Does it support subscriptions?
Not today. ALGRA Paddle for WooCommerce takes one-time payments. It does not create Paddle subscriptions or work with WooCommerce Subscriptions, and it cannot migrate existing Paddle subscriptions.
Can I sell physical products?
No. Paddle's acceptable use policy does not allow physical products or anything that needs physical delivery. Use it for software, digital downloads, ebooks, hosting, online training and similar digital products and services.
Who handles sales tax and VAT?
Paddle is the Merchant of Record, so Paddle is the seller on each transaction and calculates, collects and remits the sales tax and VAT due on it, under your agreement with Paddle.
Will my customers be charged tax twice?
Not with the default settings. WooCommerce tax is left out of the amount sent to Paddle, fees named as tax are skipped, and prices are sent as tax-inclusive. Keep WooCommerce tax turned off and leave the tax mode on "Tax included in the price", and customers pay exactly the total your checkout shows.
Do coupons, fees and dynamic pricing still work?
Yes. Paddle is charged from the WooCommerce order totals, so whatever your store calculates is what gets sent. If individual lines cannot be made to add up to the order total exactly, the order is sent to Paddle as a single line instead.
Does it work with the Checkout block and the classic checkout?
Yes, both. The embedded mode is available with the Checkout block only; the other modes work with both. See the checkout experiences table for details.
Is it compatible with HPOS?
Yes. The plugin declares compatibility with High-Performance Order Storage and uses WooCommerce order APIs throughout.
Can I refund from WooCommerce?
Yes. Full and partial refunds from the WooCommerce order screen are sent to Paddle as refund adjustments. Paddle reviews most live refunds before paying them out, and its decision is added to the order notes.
What happens if I refund from the Paddle dashboard?
The refund is recorded as a note on the WooCommerce order, so the history stays visible in WooCommerce. Record the refund amount in WooCommerce yourself if you need it in your WooCommerce reports.
What if a webhook is late or fails?
Webhooks are signature-verified and are the main way orders are updated. When a customer returns to the order-received page, ALGRA also checks the transaction with Paddle directly, so a delayed webhook does not leave that order unpaid.
Which currencies are supported?
More than 30 of the currencies Paddle supports. If your store currency is not one of them, the payment method hides itself at checkout and the settings screen tells you why.
Which payment methods will customers see?
Whichever methods you have enabled in Paddle, optionally narrowed down in the plugin settings. Paddle then shows each customer the methods available for their country, currency and device, so not every customer sees every method.
Does my domain need Paddle approval?
Yes, for live payments. Paddle has to approve your website before you can set a default payment link and take live payments. You can test everything in sandbox while you wait.
Why does Paddle appear on receipts and bank statements?
Because Paddle is the Merchant of Record, it is the seller of record on each transaction and issues the receipt. That is how Paddle takes on the tax and payment responsibilities for the sale.
Can I test before going live?
Yes. Sandbox and live use separate API keys, client-side tokens and webhook secrets, so you can run complete test orders in Paddle sandbox before switching live on.
Will it work with checkout field plugins?
The overlay and payment-page modes open Paddle only after WooCommerce has validated and created the order, so custom required fields are enforced first. The embedded mode checks WooCommerce address fields before showing payment. If you rely on extra required fields, use an overlay or payment-page mode, and test in sandbox.
No questions match that search.
Other Paddle integrations
-
Paddle for Easy Digital Downloads
Paddle checkout for one-time Easy Digital Downloads sales. Does not work with EDD Recurring.
-
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 WooCommerce as your source of truth.
Let Paddle handle checkout, payment and tax as Merchant of Record, without building or syncing a second catalog.
For digital products and services · One-time payments