Should affiliates earn commission while a Paddle subscription is paused?
Short answer: Normally, a paused Paddle Billing subscription does not generate new recurring charges, so a revenue-based affiliate program should not create fresh commission simply because the subscription remains associated with a referred customer. Preserve the original referral mapping, wait for a qualifying collected transaction, and apply the written program policy when billing resumes. A pause is not a cancellation and a resume is not necessarily a new acquisition.
If the customer cancels rather than pauses, use our Paddle cancellation commission cutoff guide to distinguish scheduled end dates, immediate cancellation and outstanding transactions.
The important distinction is between a subscription lifecycle event and commissionable revenue. Paddle documents that a paused subscription stops generating new transactions until it resumes. A scheduled pause, however, does not take effect until the designated billing boundary. Read the official pause and resume workflow before implementing commission logic.
Separate scheduled pauses, effective pauses and resumed billing
| State or action | Billing implication | Suggested commission treatment |
|---|---|---|
| Pause scheduled for next billing period | Subscription remains active until the scheduled change takes effect | Continue normal eligibility checks on genuinely paid invoices before the pause |
| Pause immediately | Subscription becomes paused; no new recurring billing while paused | Do not create a commission from the pause event itself |
| Resume and start a new billing period | A new transaction is created and payment is attempted | Evaluate the new transaction only after the required payment status is confirmed |
| Resume and continue existing billing period | May resume without an immediate charge if still inside the retained period | Do not award a new commission for a no-charge resume |
| Past-due or failed collection | Revenue may remain uncollected | Keep the commission pending or ineligible until your payment rule is satisfied |
Paddle's resume billing-period options describe start_new_billing_period and continue_existing_billing_period. The default starts a new period. Continuing the existing period is not permitted for subscriptions that were past due when paused. Never assume a resume means a payment has settled.
Write the affiliate policy before implementing the webhook handler
Decide whether an affiliate earns on every eligible paid renewal, only the first invoice, or a fixed number of billing periods. Then document how pauses affect the duration limit. Two reasonable policies differ: a calendar-based 12-month entitlement can expire during a three-month pause, while a 12-paid-invoice entitlement can resume after the pause. Neither rule is universally correct. Publish the choice and keep a versioned copy of the terms attached to each referral.
Also define the eligible base: net collected subscription revenue, before or after tax, and after applicable discounts or credits. State how refunds and chargebacks reverse commissions. For broader plan changes, see our Paddle upgrade and proration commission guide and refund reconciliation workflow.
Implement an event-safe pause and resume workflow
- Persist stable identity. Store internal account ID, Paddle customer ID, subscription ID, referral ID, affiliate ID and the applicable policy version. Do not use the current price ID as referral identity.
- Record scheduled changes. When a pause is scheduled, keep the future effective timestamp and avoid prematurely marking the subscription as paused.
- Consume lifecycle events. Listen for subscription status changes, including
subscription.pausedandsubscription.resumed. Use these to update state, not to create money entries. - Reconcile billing independently. Match transaction IDs to verified payment outcomes. Apply the eligibility rule only once for each unique eligible transaction.
- Reverse accurately. Process refunds and adjustments against the original commission entry rather than overwriting history.
- Retry safely. Store event IDs and idempotency keys so repeated webhook delivery cannot duplicate rewards.
For a practical design, maintain two ledgers: a subscription status history and a commission ledger. The former records scheduled_pause, paused, resumed and timestamps; the latter records invoice or transaction IDs, eligible amounts, commission rates, pending or approved states and reversals. A status event can update the first ledger without touching the second.
Worked example: pause mid-cycle and resume later
Assume a hypothetical $100 monthly subscription and a 20% commission on eligible collected renewals. A customer pays $100 on January 1, earning a $20 pending commission. They pause on January 15. No new recurring charge is generated in February. Under a revenue-based policy, the affiliate earns $0 for February, not another $20. If the customer resumes March 1 with a new billing period and a qualifying $100 transaction is successfully collected, a new $20 commission may be recorded.
If instead the customer resumes within an existing billing period using the option that produces no immediate charge, the resume event alone earns $0. Later eligible billing can earn commission under the published terms. This example is illustrative, not a claim about a vendor's default affiliate settings.
Acceptance checklist for finance and engineering
- Test immediate pause and scheduled pause separately, including status timestamps.
- Test resume with both billing-period choices and a failed collection.
- Confirm there is no commission for a zero-charge resume.
- Reconcile payment, credit and refund events to one immutable transaction ID.
- Check the calendar-month versus paid-invoice entitlement rule.
- Test duplicate and out-of-order webhook deliveries.
- Show the affiliate a clear explanation for pending, paused and reversed earnings.
Frequently asked questions
Does pausing a Paddle subscription remove the affiliate attribution?
No. Your integration should retain the referral relationship unless your own published attribution policy says otherwise. Paddle's subscription state does not automatically define your affiliate entitlement.
Does a resume event guarantee payment?
No. A new transaction can be attempted and fail. Base revenue commissions on verified eligible payment outcomes, not just the subscription status.
Should a paused month count toward a 12-month commission cap?
That depends on whether your terms define 12 calendar months or 12 qualifying paid invoices. Make the distinction explicit before launch.
Sources and editorial disclosure
Official references: Paddle pause workflow, resume API and billing-period options. Documentation reviewed 1 November 2026. Examples and proposed affiliate rules are editorial guidance, not hands-on testing or legal advice.
For failed renewal payments and dunning, see Paddle Billing dunning and past-due commission rules.