architecture decision
ADR-018: Use a recovery window for subscription payment failures
Failed subscription payments enter a recovery window before cancellation so retry and customer update flows can complete.
Decision RecordMay 5, 2025AcceptedSubscriptions
Context
Immediate cancellation after a failed renewal creates avoidable churn. Customers often update payment details after reminders.
Decision
Subscription payment failures enter a recovery window. SubscriptionRecoveryAgent can recommend outreach and retry timing, while cancellation remains a command.
Consequences
Customer retention improves and cancellation remains auditable. The recovery window must be visible in support and billing metrics.