Payments, renewals and refunds
Payments
- The customer pays a mapped price with Paddle Checkout.
- Paddle notifies LicenseManager with a
transaction.completedevent, signed with the secret of the notification destination. Events with a wrong or old signature are rejected, and an event delivered twice is processed once. - LicenseManager reads the customer from Paddle: their email and name.
- The licenses are created: for each item of a mapped one-time price, as many licenses as its quantity, with the mapping’s policy. Each license records its price after discounts and before taxes, and the transaction it comes from.
- The customer receives their keys in one email.
The customer is found by email among the product’s customers, or created, and linked to their Paddle customer.
When a payment creates nothing
- None of its items is a mapped price.
- The transaction isn’t completed, like a failed payment.
- The integration is in Error or Disconnected: see when the integration breaks.
Renewals
One-time licenses don’t renew: selling the price again creates a new license. Subscriptions renew on their own: see subscriptions.
Refunds of canceled licenses
When a license bought through Paddle is canceled, by the customer during its money back guarantee or by you, LicenseManager requests the refund of its share of the transaction, taxes included, as a refund adjustment of the transaction’s item.
Paddle reviews refunds. Small refunds are often approved at once; others stay pending until Paddle approves or rejects them, which LicenseManager learns from Paddle’s adjustment.updated event:
| Refund status | Meaning |
|---|---|
| Pending Paddle’s review | Requested, waiting for Paddle. The customer is told a refund was requested. |
| Refunded | Approved by Paddle. A license.refunded event is recorded. |
| Rejected by Paddle | A license.refund_failed event is recorded: refund the transaction from Paddle if you need to. |
Paddle accepts one pending refund per transaction. When a customer cancels two licenses of the same transaction while the first refund is still reviewed, the second is retried for about half an hour, then recorded as failed: refund it from Paddle.
Refunds need the optional Adjustments: Write permission, and can be turned off on the Paddle refunds card. When you cancel a license, you can also choose not to refund it.
Refunds made from the Paddle dashboard don’t change the licenses: cancel them in LicenseManager.
When the integration breaks
While the integration is in Error or Disconnected, for example after the API key is revoked, customers can still pay in Paddle, but no license is created, and these licenses aren’t created once it’s fixed. The owners and admins of the organization are emailed as soon as the daily check finds the problem. Fix it, then check your Paddle transactions of the period, and create the missing licenses from the dashboard.