Paddle Billing trial and webhook documentation reviewed 11 November 2026. This guide is based on published developer docs, not live testing.
Does extending a Paddle trial extend an affiliate’s commission window?
Not automatically. Paddle can extend a trial by moving a trialing subscription’s next_billed_at date, but that billing operation does not itself define an affiliate commission contract. If the program pays on the first successful charge, the earning event moves with the eventual payment. If a referral eligibility window is measured from signup, extending the trial may not extend that window unless the program terms say so. Keep attribution, trial eligibility and commission timing as separate fields.
For the general free-trial funnel, see our affiliate attribution from free trial to paid SaaS guide. This article focuses specifically on Paddle’s trial-extension API and its effect on commission timing.
What Paddle actually changes when a trial is extended
Paddle’s trial extension documentation explains that a trialing subscription has status trialing and no immediate charge. The first payment is expected at next_billed_at. Moving that date later extends the trial. When a successful payment activates the subscription, Paddle changes its billing period from trial-based dates to the normal billing cycle.
For a trialing subscription, Paddle permits updating items and next_billed_at; the documented request for a date change uses proration_billing_mode=do_not_bill. This is a billing API rule, not a commission-rate setting. The documentation says the new date must be at least 30 minutes in the future for this operation.
| Situation | Billing meaning | Recommended affiliate state |
|---|---|---|
| Trial signup | Subscription trialing, not charged | Attributed lead or trial, not paid conversion |
| Trial extended | Next billing date moves later | Keep affiliate ID and original referral timestamp |
| Trial shortened | Billing attempt moves earlier | Wait for successful payment before earned commission |
| Early activation | Trial ends and billing begins | Reconcile the resulting paid transaction |
| Cardless trial with no payment method | Payment method needed to charge | Do not treat activation request as paid revenue |
| Trial expires without successful payment | No qualifying first paid transaction | Keep or expire attribution according to terms; no cash commission |
Which events should drive your ledger?
The subscription.trialing event identifies trial status, while subscription.activated indicates that a trial ended and the customer was successfully billed. Paddle also documents transaction.paid as the earliest reliable captured-payment signal and transaction.completed as the fully processed transaction. For a commission ledger, use the transaction to reconcile actual eligible amount, rather than awarding a flat amount solely from a subscription status change.
Webhook order can vary in real integrations, and retries can duplicate deliveries. Persist Paddle subscription and transaction IDs, verify webhook signatures and process each qualifying transaction once. A trial extension may emit subscription updates but should not create commission merely because the status or billing date changed.
Worked example: a 14-day trial extended to 28 days
Suppose a SaaS business offers a 14-day trial and a $60 monthly plan. An affiliate referred the user on 1 November. The merchant extends the trial to 29 November. Under a 20% first-paid-invoice bounty, the referral is stored on 1 November but earns no commission on day 14. If Paddle successfully bills $60 on 29 November and the transaction completes, the eligible commission is $12, subject to the refund hold. If payment fails, payable commission remains zero until a qualifying payment succeeds.
Now compare two possible eligibility contracts. A program that requires conversion within 30 days of the referral would still accept a 29 November payment, but might reject a further extension to 15 December. A program that measures the deadline from the first successful invoice would handle the same extension differently. Neither deadline is imposed by Paddle; both are merchant-defined affiliate terms. Publish the policy before inviting partners.
Early activation and manual collection are not identical
Paddle’s activate-a-trial operation is for automatically collected subscriptions. The docs direct merchants with manually collected subscriptions to change the billing date instead. For cardless trials, the customer must add a payment method before charging. Do not build a commission trigger that assumes calling the activation endpoint always produces a completed paid transaction. Use the actual resulting billing event and the appropriate payment evidence.
For a manually invoiced enterprise account, the creation or activation of a subscription can precede cash collection. Read our Paddle dunning guide and the dedicated manual invoice article for collection-specific handling.
Store a trial-aware attribution record
- Referral identity: affiliate ID, referred customer ID, source, original click or signup time and any approved coupon.
- Subscription identity: Paddle subscription ID, trial start, original trial end, current
next_billed_atand extension history. - Contract: attribution expiry, first-payment qualification, recurring commission duration, exclusions and hold period.
- Payment evidence: transaction ID, completed status, eligible line items, currency, discounts, refunds and tax exclusions.
- Commission ledger: pending, approved, payable, paid and reversed entries with an idempotency key.
A trial extension changes the planned billing date, not the historical referral date. Preserve both so finance can explain why an affiliate was credited or declined. If the customer later changes plans, apply the separate Paddle upgrade commission rules.
QA scenarios for Paddle trial attribution
| Test | Expected behavior |
|---|---|
| Signup starts trial | Referral recorded, commission not payable |
| Trial extended twice | Same affiliate, updated billing date, no duplicate referral |
| Early activation succeeds and payment completes | One qualifying commission if terms allow |
| Cardless trial lacks payment method | No paid conversion without payment |
| Trial expires and billing fails | Pending or no commission, not paid |
| Webhook replay after activation | One ledger entry per eligible transaction |
| Trial extension exceeds contractual attribution window | Explicit policy decision logged, not silent overwrite |
Frequently asked questions
Does subscription.trialing count as a sale?
No. It confirms trial status. You may track it as a trial conversion, but a paid-revenue commission requires the contract’s qualifying billing event.
Can I extend a Paddle trial without proration?
Paddle’s documented trial date update uses proration_billing_mode=do_not_bill; the trial is not yet on its normal paid billing cycle.
What happens if the customer activates early?
For automatically collected subscriptions, Paddle supports early activation. Reconcile the resulting paid and completed transaction before paying an affiliate, and apply any contractual conversion window.
Official sources reviewed
- Paddle: extend or activate a trial
- Paddle: subscription.trialing
- Paddle: subscription.activated
- Paddle: webhook lifecycle and verification
Editorial disclosure: This independent guide summarizes first-party Paddle documentation checked 11 November 2026. All commission rates, deadlines and examples are proposed merchant policy choices, not automatic Paddle affiliate functionality. No hands-on test is claimed.