Paddle Billing
Search

Subscription paused scenario

Simulates all events that occur when a subscription is paused.

  1. Scheduled change created — pausing on next billing period only

    This step only occurs when subscriptions are paused on the next billing period.

    subscription.updatedIf paused on the next billing period, Paddle updates the scheduled_change object against the subscription to say the subscription is set to pause.
  2. Subscription pauses

    subscription.updatedWhen scheduled_change.effective_from elapses, or if paused immediately, Paddle updates billing dates for the subscription and any items. Its status changes to paused.
    subscription.pausedOccurs because the subscription status changes to paused.
  3. Past due renewal transactions canceled — past due only

    This step only occurs when subscriptions have past due transactions for renewals.

    transaction.updatedWhen a subscription has transactions with the origin of subscription_recurring and the status of past_due, Paddle automatically cancels them to avoid double-charging a customer on resume when a new billing period is created. The related transaction status is changed to canceled.
    transaction.canceledOccurs because the related transaction status changes to canceled.

Related pages