// Glossary
Grace period
A window after a failed renewal charge during which the subscriber keeps access.
An optional window (configured in App Store Connect) after a failed renewal charge during which the subscriber keeps full access while Apple retries billing. Honest MRR keeps grace-period subscribers in the paying base: they haven't churned, their card just bounced.
In the notification stream it looks like this. The failure arrives as DID_FAIL_TO_RENEW with the subtype GRACE_PERIOD, which is Apple telling you to keep serving the subscription. If billing recovers you get DID_RENEW with the subtype BILLING_RECOVERY. If it does not, you get GRACE_PERIOD_EXPIRED, and that is when entitlement should end.
A DID_FAIL_TO_RENEW with no subtype means there is no grace period configured for that subscription, and access can stop immediately.
Because the whole point of a grace period is recovery, counting it as churn on day one both overstates churn and understates the paying base, and it hides the involuntary-churn problem you could actually fix.
See: Paying states in the methodology →
// Related terms
// Related