How to detect a subscription is in billing retry (60 days)?

  • 31 March 2023
  • 1 reply

Badge +1

I viewed Apple's docs and saw the information about billing retry (60 days), but not in RevenueCat. I want to know how to detect a subscription is in billing retry (60 days)? 

Is Billing_issue when payment is failed before billing retry? Is Expiration when subscription is officially expired (after 60 days retry)?

1 reply

Userlevel 4
Badge +6

Hey @Tran Hien ,


A billing issue is what we sent wen a payment fails in result of payment issues from the respective store. RevenueCat will only send one billing issue event -- additional payment failures won't trigger additional billing issue events, unless a renewal is successful between payment failures or the subscription ends and is restarted.  Once the billing issue is detected, a grace period will start.

When a subscription enters a grace period, RevenueCat detects the change automatically. Users will retain access to their subscriptions, but we'll immediately send events indicating the subscription has been cancelled. These subscriptions are considered cancelled because they are now past due, but will not be considered expired until the end of their grace period. During this time, a subscription may convert to paid through additional billing attempts from the store or by the customer updating their billing information.


For more information on billing issues, we have a useful document here: