The EXPIRED notification fires when a subscription has expired and the customer no longer has access. This is the final state in the churn path — the subscription is over.
When does it fire?
This notification triggers when a subscription period ends without a successful renewal. Subtypes indicate the reason:
- Voluntary — the customer disabled auto-renew and the period ended
- Billing retry period over — billing retries exhausted after a payment failure
- Price increase declined — the customer didn't consent to a price increase
Payload highlights
The signed transaction info includes the final expiration date and the original purchase date. The signed renewal info may include the expiration intent, showing why the subscription expired.
How Yeethook helps
Yeethook delivers expiration events with clear context about why the subscription ended. This helps your team segment churned subscribers by reason and take appropriate action (win-back offers for voluntary churn, payment update prompts for billing failures).
Common use cases
- Track churn rates and segment by expiration reason
- Trigger win-back offer campaigns for recently expired subscribers
- Monitor the effectiveness of billing retry and grace period policies
- Audit subscription lifecycle from acquisition to expiration