The GRACE_PERIOD_EXPIRED notification fires when the billing grace period after a failed renewal has ended without Apple successfully collecting payment. The customer's subscription access should be revoked at this point.
When does it fire?
This notification triggers when the grace period window closes. During the grace period, the customer retained access while Apple retried billing. If all retries fail, this notification signals that access should be removed.
Payload highlights
The signed transaction and renewal info show the final billing retry status and the grace period end date. This is your signal to revoke premium access for the affected subscriber.
How Yeethook helps
Yeethook delivers this notification clearly formatted so your team knows exactly which subscriber lost access and why. This is critical for apps that need to revoke features or content access based on subscription status.
Common use cases
- Revoke premium feature access when grace periods end
- Send a final payment update reminder before access is lost
- Track grace period resolution rates to optimize retention
- Monitor involuntary churn caused by billing failures