Paddle Billing × Paid Memberships Pro

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

    The next page opens Paddle

    Inline is this gateway’s default. Overlay is available on the same payment page.

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

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.

1 · Paid Memberships Pro

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
2 · ALGRA

Builds the Paddle charge

  • One-time levels are a single charge
  • Recurring levels are a subscription
  • The first charge can differ from the renewal
3 · Paddle Billing

Payment, then membership

  • The member pays on the next page
  • The level starts after Paddle confirms payment
  • Later renewals are new membership orders
Merchant of Record

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

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

Checkout

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.

Global checkout

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.

Payment safety

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

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

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.

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.updatedsubscription.activatedsubscription.trialingsubscription.updatedsubscription.canceledsubscription.past_due
  4. 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.

Is it right for you?

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

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

FAQ

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.

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