Paddle subscriptions
Map a recurring price of Paddle, and each subscription to it gets one license, valid while the subscription is paid. It renews with each payment, includes every update, and expires on its own when the subscription ends.
Set it up
Give the API key the subscription permissions
Subscriptions: Read is required once a recurring price is mapped. Subscriptions: Write (to cancel subscriptions from LicenseManager) and Customer portal sessions: Write (to link the customer portal to Paddle’s) are optional. See permissions.
Map a recurring price
See mapping prices.
Sell it
Open Paddle Checkout with the price. The license is created when the subscription starts, and its key emailed to the customer.
What a subscription license gets
- An expiration at the end of the paid period, plus the grace period while a renewal is due.
- Every update, whatever the policy’s max version.
- The policy’s machines times the quantity subscribed: 3 seats of a policy allowing 2 machines allow 6.
- No money back guarantee: customers cancel their subscription instead.
- Its price for one period, before taxes.
The subscription’s life
The first payment
The license is created when Paddle creates the subscription or completes its first transaction, whichever comes first, for the email of the Paddle customer. Trials create it too: it’s valid until the trial ends.
Renewals
Each completed renewal extends the license to the end of the new period, and is recorded as a license.payment_succeeded event.
Grace period
When a renewal fails, Paddle retries it as its dunning settings say, and the subscription is past_due. The license stays valid for the integration’s grace period after the period ends, 7 days by default, set on the Paddle subscriptions card. Set it to your Paddle retry schedule.
When the subscription ends
- Canceled at the end of the period: the license expires at the end of the period, without grace.
- Canceled at once: the license expires right away.
- Paused: the license expires when the pause starts. When the subscription is resumed, it’s valid again until the end of the new period.
A license.subscription_ended event is recorded when the subscription is canceled or paused.
Plan and quantity changes
Switching the subscription to another mapped price moves the license to that price’s policy. Changing the quantity updates its machines.
Canceling
- From LicenseManager: canceling a subscription license cancels its Paddle subscription at once, without a refund. Needs Subscriptions: Write.
- As a customer: from the Paddle customer portal, opened from the customer portal.
Subscription payments are never refunded by LicenseManager: refund them from Paddle.