⚡ Connect Paddle Billing to WooCommerce — In Under 5 Minutes

Paddle Payment for WooCommerce is the most seamless and feature-complete way to integrate Paddle Billing into your WooCommerce store. Just enter your API credentials, configure webhooks, and you’re live — the plugin handles everything else automatically.

No manual product mapping. No manual price configuration. No complicated setup wizards. Your WooCommerce products are automatically synced to Paddle’s catalog on first checkout — including product images, descriptions, tax categories, and pricing.

Fully Compatible with WooCommerce’s Official Subscriptions Plugin — Seamlessly works with the official WooCommerce Subscriptions plugin by Woo. Manage the complete subscription lifecycle — from creation to renewal to cancellation — all powered by Paddle Billing, right from your WooCommerce dashboard.

What Makes This Plugin Different?

Fully Automatic Product & Price Sync

This is where most Paddle plugins fall short. With our plugin, you never need to manually create products or prices in your Paddle Dashboard. The plugin automatically:

Creates products in your Paddle catalog at first checkout (with images, descriptions, tax settings)
Creates matching price objects with the correct currency and amount
Auto-syncs price changes — when you update a product price in WooCommerce, it’s instantly pushed to Paddle via the Prices API
Caches Paddle product IDs and price data as post meta for lightning-fast subsequent checkouts

️ Automatic Coupon & Discount Sync

Apply a WooCommerce coupon at checkout and it’s automatically synced to Paddle as a discount. No need to create discounts separately in Paddle Dashboard. Supports:

Percentage discounts (percent → percentage)
Fixed cart discounts (fixed_cart → flat)
Fixed product discounts (fixed_product → flat_per_seat)
Existing Paddle discounts are automatically matched by code — no duplicates created
Discount IDs are stored on coupon meta for instant reuse on future orders

Complete Subscription Lifecycle Management

Fully compatible with WooCommerce’s official Subscriptions plugin — not just basic support, but the entire lifecycle:

Creation	Creates subscription on Paddle, links Paddle subscription ID to WooCommerce subscription
First Payment	Activates subscription, completes parent order, stores transaction ID
Renewals	Automatically creates renewal orders via webhook, schedules next payment date
Free Trials	Supports daily, weekly, monthly, yearly trials — synced to Paddle’s trial_period
Variable Subscriptions	Intelligent price plan matching for variable-subscription products
Cancellation	Cancel from WooCommerce → cancels on Paddle. Cancel from Paddle → cancels in WooCommerce
Suspension & Reactivation	Pause and resume subscriptions — both directions fully synced
Payment Method Changes	Customers can update payment method through Paddle checkout
Amount & Date Changes	Subscription amount and billing date modifications supported
Past Due / Failed	Automatic status update when payment fails — no manual intervention needed

⭐ Complete Feature List

Auto Product Sync	WooCommerce products auto-created in Paddle catalog on first checkout. Product name, image, description, and tax category all synced.
Auto Price Sync	Update a product price in WooCommerce → automatically pushed to Paddle. No manual updates needed.
️ Auto Coupon Sync	WooCommerce coupons auto-synced to Paddle discounts. Percentage, flat, and flat-per-seat types supported.
Full Subscription Support	Complete WooCommerce Subscriptions lifecycle — creation, activation, renewal, cancellation, suspension, reactivation, trials, variable subscriptions.
Full & Partial Refunds	Process refunds directly from WooCommerce admin. Both full and partial refunds via Paddle’s Adjustments API.
Real-Time Webhooks	9 webhook events handled — transactions, refunds, subscriptions. Cryptographic signature verification using Paddle’s official PHP SDK.
Checkout Blocks Support	Native support for WooCommerce Checkout Blocks. Works with both classic shortcode and block-based checkout.
⚡ HPOS Compatible	Explicitly declares HPOS (High-Performance Order Storage) compatibility for fast order processing.
Built-in Sandbox Mode	Toggle between live and sandbox environments. Separate API credentials for each. Test your entire flow without real transactions.
Secure Checkout Overlay	Paddle checkout opens as a secure overlay modal — customers never leave your site. PCI-DSS compliant.
️ Paddle Info Metabox	View linked Paddle Product ID in WooCommerce product editor. One-click link to open product in Paddle Dashboard.
26+ Currencies	USD, EUR, GBP, AUD, CAD, JPY, INR, BRL, CHF, CNY, and 16+ more. Auto-validation at activation.
Transaction Search	Search WooCommerce orders by Paddle Transaction ID directly from the orders list.
Translation Ready	Fully internationalized with .pot file included. All strings follow WordPress i18n standards.
Detailed Order Notes	Every webhook event, payment, refund, and subscription change is logged as an order note for full audit trail.

Webhook Events Processed

`transaction.completed` / `transaction.paid`	Order marked as completed, Paddle transaction ID stored
`adjustment.updated`	Full or partial refund processed, order status updated
`subscription.created`	Paddle subscription ID linked to WooCommerce subscription
`subscription.activated` / `subscription.resumed`	Subscription activated, renewal orders created, next payment scheduled
`subscription.past_due`	Subscription payment marked as failed
`subscription.canceled` / `subscription.paused`	Subscription canceled or paused in WooCommerce

All webhooks are cryptographically verified using Paddle’s official PHP SDK — no spoofed events can get through.

⚙️ Setup in 3 Simple Steps

Install & Activate — Upload the plugin from your WordPress dashboard.
Enter Credentials — Go to WooCommerce → Settings → Payments → Paddle and paste your API Key, Client-side Token, and Webhook Secret.
Add Webhook URL — Copy the auto-generated webhook URL from settings and add it as a Notification Destination in your Paddle Dashboard.

Done! Your products, prices, and coupons will sync to Paddle automatically from the very first checkout. No manual configuration needed.

️ Security & Code Quality

Webhook Signature Verification — Every webhook verified using paddlehq/paddle-php-sdk with PSR-7 request handling
Nonce-Protected AJAX — Order-specific nonces for all checkout AJAX requests
One-Time Session Tokens — Checkout sessions are invalidated after first use to prevent replay attacks
Full Input Sanitization — All inputs sanitized with sanitize_text_field, absint, esc_html
Modern PHP 8.1+ — Written with modern PHP standards including typed properties, match expressions, and proper namespacing
WordPress Coding Standards — Follows WPCS for clean, maintainable code

How We Compare

Feature	Our Plugin ✅	Other Paddle Plugins
Paddle Billing API (Latest)	✅ Full Support	❌ Most use deprecated Classic API
Auto Product Sync	✅ Automatic on first checkout	❌ Manual product creation required
Auto Price Sync on Update	✅ Instant push to Paddle	❌ Not available
Auto Coupon/Discount Sync	✅ Full sync with dedup	❌ Not available
WooCommerce Subscriptions	✅ Complete lifecycle (10 events)	⚠️ Basic or partial
Variable Subscriptions	✅ With price plan matching	❌ Not supported
Free Trial Support	✅ Daily/Weekly/Monthly/Yearly	❌ Rarely supported
Full & Partial Refunds	✅ Both from WooCommerce admin	⚠️ Full only or none
Checkout Blocks	✅ Native integration	❌ Not supported
HPOS Compatible	✅ Explicitly declared	❌ Rarely
Webhook Signature Verification	✅ Official SDK + PSR-7	⚠️ Basic or none
Sandbox Mode	✅ Built-in with separate credentials	⚠️ Sometimes

Requirements

Requirement	Version
PHP	8.1+
WordPress	5.8+
WooCommerce	3.9.2+
PHP Extensions	cURL, JSON, mbstring
Paddle Account	Paddle Billing (not Classic)
SSL	Required for webhooks

What You Get

✅ Full Plugin Source Code (unencrypted, unobfuscated)
✅ Translation-Ready .pot File
✅ Detailed Documentation
✅ 6 Months Support (extendable to 12)
✅ Lifetime Updates

FAQ

Q: Do I need to manually create products in my Paddle Dashboard?

A: No! Products are automatically created in your Paddle catalog when a customer completes their first checkout. Product name, image, description, and tax category are all synced automatically.

Q: What happens when I change a product price in WooCommerce?

A: The new price is automatically pushed to Paddle via the Prices API — no manual update needed.

Q: Does it work with WooCommerce Checkout Blocks?

A: Yes! Native Checkout Blocks support is included. Works with both classic shortcode and the block-based checkout editor.

Q: Can I test before going live?

A: Absolutely. Toggle sandbox mode in settings and use your Paddle Sandbox credentials. Test your entire payment flow without processing real transactions.

Q: Does it support WooCommerce Subscriptions?

A: Full lifecycle support — creation, activation, renewals, cancellation, suspension, reactivation, free trials, variable subscriptions, payment method changes, and failed payment handling.

Q: Can I process refunds from WooCommerce?

A: Yes — both full and partial refunds directly from your WooCommerce order admin. Uses Paddle’s Adjustments API.

Q: Are WooCommerce coupons supported?

A: Yes! Coupons are automatically synced to Paddle discounts — percentage, flat, and flat-per-seat types. Existing Paddle discounts are matched by code to avoid duplicates.

Q: Is this compatible with HPOS?

A: Yes, the plugin explicitly declares HPOS compatibility.

Changelog

v1.0.0 — Initial Release

Paddle Billing API integration with auto product & price sync
Full WooCommerce Subscriptions lifecycle support
Automatic coupon/discount sync to Paddle
Full & partial refunds from WooCommerce dashboard
Real-time webhook processing with signature verification
WooCommerce Checkout Blocks native support
HPOS compatibility
Built-in sandbox mode
26+ currencies
Translation-ready (.pot file)

️ Tags

paddle, paddle billing, woocommerce paddle, paddle woocommerce, paddle gateway, paddle integration, woocommerce subscriptions, paddle subscriptions, paddle refund, paddle checkout, paddle webhook, checkout blocks, hpos

* Subscription features require the WooCommerce Subscriptions plugin to be installed and active.

Paddle Checkout for WooCommerce – Supports Subscriptions & Recurring Payments