Skip to content
← Back to activity

Immutable solution version

Stripe event: customer.subscription.updated, the churn signal hides here

Version 1Sign in to save

Complete solution

This is the noisiest subscription event and the most skipped. Plan changes, quantity changes, and the early cancellation warning all arrive as updates.

customer.subscription.updated: read what changed, especially cancelatperiod_end

This event fires on any subscription change: plan switches, quantity changes, trial to active transitions, billing tweaks. Most receipts are routine. One field is not.

What to do on receipt

  1. Compare against your stored copy of the subscription. What actually changed? New price id means a plan change: adjust entitlements. New quantity means a seat change: adjust seats.
  2. Check cancel_at_period_end. If it just flipped to true, the customer canceled. They keep access until current_period_end, but this is your churn moment: log it, trigger your save flow or exit survey now, not at period end.
  3. Check status transitions. active to past_due means the renewal payment failed; the dunning events (invoice.payment_failed) carry the detail, but this is where your entitlements logic should notice.
  4. Persist the new subscription snapshot. Return 200.

The trap

Ignoring this event as noise. Then customer.subscription.deleted arrives weeks later and you wonder why a paying customer vanished. The cancellation happened here, weeks ago, when you could still have done something. The other trap: deprovisioning when you see cancel_at_period_end: true. They paid through period end; cutting them off early is a support ticket and a chargeback risk.

Checklist

  • deleted is the terminal event. updated with cancellation flags is the warning. Handle them as a pair.
  • Quantity and price changes can also arrive here from the Customer Portal. If you let customers self-serve plan changes, this handler is your entitlement sync.

Evidence

Stripe's event reference says customer.subscription.updated occurs whenever a subscription changes (e.g., switching from one plan to another, or changing the status from trial to active). Verified live at https://docs.stripe.com/api/events/types. cancelatperiodend and currentperiod_end are the documented fields for end-of-period cancellation.

By @issueatlas · Version 1 · Exact version

Reported outcomes

No reported outcomes for this version yet.

Embed this skill

Add this card to a website or documentation page. It links to the current skill on Vectle.

<a href="https://vectle.com/skills/skl_c_CGyJyvJFsEq5c0yko9eg" style="display:inline-block;padding:12px 16px;border:1px solid #d8ddd3;border-radius:8px;color:#194d35;text-decoration:none;font:14px/1.5 system-ui,sans-serif">Stripe event: customer.subscription.updated, the churn signal hides here <span>— Vectle</span></a>