Paddle checkout for Paid Memberships Pro.
Levels, prices, and discount codes stay in Paid Memberships Pro. Paddle opens on the next page, and the membership starts after Paddle confirms the payment. One-time levels are a single charge. Recurring levels become a Paddle subscription.
- One-time and recurring levels
- Free trials
- Sandbox and live
- 1
Checkout starts in PMPro
The member submits Paid Memberships Pro checkout. Paddle is not on that form. The level is not assigned yet.
- 2
The next page opens Paddle
Inline is this gateway’s default. Overlay is available on the same payment page.
Access follows a confirmed payment
The level starts when Paddle confirms the payment. Canceling in Paid Memberships Pro schedules the end of the current billing period.
- Paddle Billing
- Paid Memberships Pro
- One-time and recurring
- Free trials
- Sandbox and live
The level price becomes the Paddle charge.
You do not create or sync Paddle products for your levels. Each checkout is sent from the level price. Paddle keeps those charges out of your product catalog.
The level, as you priced it
- Initial payment and billing amount
- A discount code changes the price that is sent
- A free trial, when the trial amount is zero
Builds the Paddle charge
- One-time levels are a single charge
- Recurring levels are a subscription
- The first charge can differ from the renewal
Payment, then membership
- The member pays on the next page
- The level starts after Paddle confirms payment
- Later renewals are new membership orders
Leave sales tax off in Paid Memberships Pro.
This gateway sends the membership price as tax-inclusive, so Paddle calculates tax inside the amount the member pays. Tax-inclusive is this gateway’s setting. If tax mode is omitted, Paddle uses the account setting.
- Merchant of RecordPaddle is the seller on the transaction and calculates, collects, and remits the sales tax and VAT due on it, under your agreement with Paddle.
- Levels stay in PMProLevel prices, discount codes, and member records stay in Paid Memberships Pro. You do not create or sync a Paddle catalog for those levels.
- Sandbox follows PMProSandbox or live follows the Paid Memberships Pro gateway environment, with separate keys and webhook secrets for each.
- 1
Leave sales tax off
Paid Memberships Pro prices the level. Sales tax in Paid Memberships Pro stays off, and that membership price is the amount sent.
- 2
Tax-inclusive is the gateway setting
This gateway sends the price as tax-inclusive. If tax mode is omitted, Paddle uses the account setting.
Paddle calculates tax inside the amount
Paddle calculates, collects, and remits the sales tax and VAT due on the digital charge, under your agreement with Paddle.
Paddle opens on the next page.
Paid Memberships Pro collects the checkout. Paddle is not on that form. The next page opens Paddle inline, which is this gateway’s default, or as an overlay. The membership starts after Paddle confirms the payment. Paid Memberships Pro checkout does not require WooCommerce. This gateway runs on that checkout. Paid Memberships Pro also documents a WooCommerce integration for payment methods that are not in its gateway list. Recurring memberships on that path use WooCommerce Subscriptions or WooCommerce Payments, and the membership price is the WooCommerce product price. Paid Memberships Pro’s payment gateway list does not include Paddle.
-
Inline
Paddle Checkout is embedded in the payment page. Inline is this gateway’s default.
-
Overlay
Paddle Checkout opens over the payment page. Overlay is the other choice on the same page.
Paddle’s payment methods and currencies.
-
Methods on the Paddle account
Checkout offers the payment methods enabled on the Paddle account. This gateway does not add methods of its own.
-
The Paid Memberships Pro currency
The gateway is offered only when the Paid Memberships Pro currency is one Paddle supports. A currency Paddle does not support is left off checkout.
Membership starts only after Paddle confirms the payment.
- The level waits for a confirmed paymentThe order is saved before Paddle is called. The level is applied when the transaction is paid or completed.
- Amount and currency must cover the checkoutAnother currency, or an amount that does not cover the checkout, does not grant the level. A larger total is accepted when Paddle added tax.
- One payment, one checkoutA Paddle payment already used for a membership cannot be reused for another checkout.
- Signed notifications onlyWebhook signatures are checked against the raw request body before a level or subscription is updated.
Renewals, cancellation, and refunds stay tied to the membership.
- A failed renewal leaves the level in placeLater recurring charges are new membership orders. A failed renewal leaves the membership level in place while the subscription is past due.
- Cancel from either sideCanceling in Paid Memberships Pro schedules the Paddle cancellation for the next billing period, so the member keeps the time already paid. Paddle does not take that cancellation within 30 minutes of the next billing time. A cancellation that starts in Paddle updates the membership.
- A refund does not cancel the subscriptionRefunding an order does not cancel the subscription. Cancel the subscription on its own. A refund of one renewal does not remove the membership level. Refunds can start from the membership order or from Paddle. Paddle reviews most live refunds before paying them out. A partial refund is made in Paddle.
- Members update their card in PaddleMembers update the payment method in the Paddle customer portal. Card numbers are not collected on the site.
What this version handles.
These limits apply on every site that uses this gateway. The membership still starts only after Paddle confirms payment.
-
Paid trials
A level whose trial amount is greater than zero is not sold through this gateway. Paddle can charge one trial price for one trial period, and this gateway does not send that price.
-
One level per checkout
This version checks out one membership level. Paid Memberships Pro 3.0 and later already lets a member hold more than one level, each from its own checkout, and a second level on the same member is outside what this version handles.
-
Discount codes
A discount code changes the price sent to Paddle, including the recurring amount. A discount that should last for a set number of renewals and then return to the full price is not supported. The subscription keeps the discounted recurring amount.
-
Price changes
The subscription keeps the price from checkout. A later edit to the level does not change that price.
-
Refunds
Refunding an order does not cancel the subscription. Cancel the subscription on its own. A refund of one renewal does not remove the membership level.
-
Sales tax
Leave sales tax off in Paid Memberships Pro. This gateway sends the membership price as tax-inclusive, so Paddle calculates tax inside the amount the member pays.
-
Paddle Classic
Paddle Classic is not supported. This gateway uses a Paddle Billing API key and a client-side token.
-
Physical goods
This gateway does not sell physical goods.
-
Failed renewals
A failed renewal leaves the membership level in place while the subscription is past due.
-
Pause and resume
Pause and resume are not offered. A subscription paused in Paddle keeps the membership level until that subscription is canceled.
-
Billing limit
When the level’s billing limit is reached, the gateway cancels the Paddle subscription immediately after that charge.
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.updatedsubscription.activatedsubscription.trialingsubscription.updatedsubscription.canceledsubscription.past_due -
Test, then go live
Run test checkouts in sandbox. Sandbox or live follows the Paid Memberships Pro gateway environment. When Paddle has approved your live domain, add the live API key, client-side token, and webhook secret for that environment.
Paddle → Checkout → Website approval
A level whose trial amount is greater than zero is not sold through this gateway. Sandbox or live follows the Paid Memberships Pro gateway environment.
Built for membership sites that bill through Paid Memberships Pro.
Great fit
- One-time membership levels
- Recurring levels, including a different initial payment and renewal amount
- Free trials, where the trial amount is zero
- Sites that already manage levels and members in Paid Memberships Pro
Not a fit
- A level whose trial amount is greater than zero is not sold through this gateway. Paddle can charge one trial price for one trial period, and this gateway does not send that price.
- This gateway does not sell physical goods.
- Products outside Paddle’s acceptable use policy.
What you need
Paid Memberships Pro
3.5+
The version this gateway runs on
WordPress
6.2+
The site Paid Memberships Pro runs on
PHP
8.0+
The version this gateway runs on
Paddle
Paddle Billing
API key and client-side token
Questions merchants ask
When does the member get access?
After Paddle confirms the payment. Submitting checkout saves the order and does not assign the level. The level is applied when the transaction is paid or completed.
Does it support recurring memberships?
Yes. One-time levels are a single charge. Recurring levels become a Paddle subscription. The initial payment can differ from the renewal amount. Later recurring charges are new membership orders.
Are trials supported?
A free trial, with the trial amount at zero, delays the first charge. Paddle still collects a payment method. A level whose trial amount is greater than zero is not sold through this gateway. Paddle can charge one trial price for one trial period, and this gateway does not send that price.
Do I have to create products in Paddle?
You do not create or sync Paddle products for your levels. Each checkout is sent from the level price. Paddle keeps those charges out of your product catalog.
How do discount codes work?
A discount code changes the price sent to Paddle, including the recurring amount. A discount that should last for a set number of renewals and then return to the full price is not supported. The subscription keeps the discounted recurring amount. A checkout that is free does not open Paddle.
Who handles sales tax and VAT?
Leave sales tax off in Paid Memberships Pro. This gateway sends the membership price as tax-inclusive, so Paddle calculates tax inside the amount the member pays. Paddle is the seller on the transaction and calculates, collects, and remits the sales tax and VAT due on it, under your agreement with Paddle. Tax-inclusive is this gateway’s setting. If tax mode is omitted, Paddle uses the account setting.
Does this require WooCommerce?
Paid Memberships Pro checkout does not require WooCommerce. This gateway runs on that checkout. Paid Memberships Pro also documents a WooCommerce integration for payment methods that are not in its gateway list. Recurring memberships on that path use WooCommerce Subscriptions or WooCommerce Payments, and the membership price is the WooCommerce product price. Paid Memberships Pro’s payment gateway list does not include Paddle.
Does a refund cancel the subscription?
Refunding an order does not cancel the subscription. Cancel the subscription on its own. A refund of one renewal does not remove the membership level. Refunds can start from the membership order or from Paddle. Paddle reviews most live refunds before paying them out. A partial refund is made in Paddle.
Does canceling in Paid Memberships Pro cancel Paddle?
Canceling in Paid Memberships Pro schedules the Paddle cancellation for the next billing period, so the member keeps the time already paid. Paddle does not take that cancellation within 30 minutes of the next billing time. A cancellation that starts in Paddle updates the membership.
Can a member hold more than one level?
This version checks out one membership level. Paid Memberships Pro 3.0 and later already lets a member hold more than one level, each from its own checkout, and a second level on the same member is outside what this version handles.
What happens if I change a level price?
The subscription keeps the price from checkout. A later edit to the level does not change that price.
Does it support Paddle Classic?
Paddle Classic is not supported. This gateway uses a Paddle Billing API key and a client-side token.
How do sandbox and live work?
Sandbox or live follows the Paid Memberships Pro gateway environment. Sandbox and live use separate API keys, client-side tokens, and webhook secrets.
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 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.
Keep Paid Memberships Pro as your membership system.
The membership starts after Paddle confirms the payment. Levels, prices, and discount codes stay in Paid Memberships Pro.
One-time and recurring levels · Free trials · A paid trial amount is not sold through this gateway