> For the complete documentation index, see [llms.txt](https://developer.paddle.com/llms.txt).

# Subscription paused scenario

Simulates all events that occur when a subscription is paused.

---


This page describes a webhook scenario with configurable inputs. Each event below lists the conditions under which it fires; combine the per-step and per-event conditions to determine what fires for any given configuration.

## Configuration

- **Subscription pauses effective from** (`effective_from`) — `immediately` *(default)* or `next_billing_period` (End of the billing period). Whether the simulated subscription should be paused immediately or at the end of the billing period.
- **Subscription has a past due transaction** (`has_past_due_transaction`) — `false` *(default)* or `true`. Whether the simulated subscription has past due transactions which need to be canceled.

## Events

### Subscription is scheduled to pause

*Only when Subscription pauses effective from is "End of the billing period".*

- [`subscription.updated`](/webhooks/subscriptions/subscription-updated) — Paddle updates the `scheduled_change` object against the subscription to say the subscription is set to pause.

### Subscription pauses

- [`subscription.updated`](/webhooks/subscriptions/subscription-updated) — *When Subscription pauses effective from is "Immediately":* Paddle updates billing dates for the subscription and any items. Its status changes to `paused`.
- [`subscription.updated`](/webhooks/subscriptions/subscription-updated) — *When Subscription pauses effective from is "End of the billing period":* When `scheduled_change.effective_from` elapses, Paddle updates billing dates for the subscription and any items. Its status changes to `paused`.
- [`subscription.paused`](/webhooks/subscriptions/subscription-paused) — Occurs because the subscription status changes to `paused`.

### Past due transactions are canceled

*Only when Subscription has a past due transaction is enabled.*

- [`transaction.updated`](/webhooks/transactions/transaction-updated) — When 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 if they resume the subscription and a new billing period is created. The `status` of the transaction is changed to `canceled`.
- [`transaction.canceled`](/webhooks/transactions/transaction-canceled) — Occurs because the past due transaction status changes to `canceled`.