Stripe webhook event
customer.subscription.updated
A subscription changed: plan, quantity, status, or billing details.
Quick answer
An upgrade, downgrade, pause, status change, or any subscription edit.
| Event type | customer.subscription.updated |
|---|---|
| Category | Subscriptions |
| When it fires | An upgrade, downgrade, pause, status change, or any subscription edit. |
| Recovery-relevant? | No |
When it fires
An upgrade, downgrade, pause, status change, or any subscription edit.
What to do with it
Re-check entitlements; watch the status field for past_due or unpaid, which signal payment trouble.
Stop building webhook handlers
SubRevival consumes the failed-payment events for you and runs the full recovery stack, no endpoint to build, secure, or maintain. 5-minute Stripe OAuth, $19/mo flat.
Start Recovering RevenueFAQ
What does the Stripe customer.subscription.updated webhook event mean?
A subscription changed: plan, quantity, status, or billing details.
When does customer.subscription.updated fire?
An upgrade, downgrade, pause, status change, or any subscription edit.
What should I do when I receive a customer.subscription.updated event?
Re-check entitlements; watch the status field for past_due or unpaid, which signal payment trouble.
Related events
Source: official Stripe events documentation.