The DID_CHANGE_RENEWAL_PREF notification fires when a customer changes which product they'll renew into — typically an upgrade or downgrade within the same subscription group.
When does it fire?
This notification triggers when a customer selects a different subscription tier:
- Upgrade (subtype
UPGRADE) — the customer switched to a higher-priced tier (takes effect immediately) - Downgrade (subtype
DOWNGRADE) — the customer switched to a lower-priced tier (takes effect at next renewal)
Payload highlights
The signed renewal info shows the new product ID the customer will renew into, along with the current product ID. For upgrades, you'll also receive a new transaction since upgrades are effective immediately.
How Yeethook helps
Plan changes directly impact your revenue. Yeethook formats these events to clearly show what plan the customer is switching from and to, so your team can track upgrade and downgrade trends.
Common use cases
- Monitor upgrade rates to measure the effectiveness of upsell prompts
- Track downgrade trends to identify pricing or value issues
- Alert your revenue team when high-value subscribers downgrade
- Analyze plan migration patterns across your subscriber base