Google Play’s suspended state after payment recovery outlasts grace: retries continue, but subscriber access does not.
Account hold is a Google Play subscription state caused by an unresolved renewal payment failure. It normally begins after any configured grace period finishes. The essential entitlement rule flips at this transition: a customer in grace keeps benefits, whereas a customer on hold must lose paid access. Google continues trying to recover the payment, so hold is not yet identical to permanent expiration or a voluntary cancellation.
Current Play behavior should be read from purchases.subscriptionsv2.get. During hold, subscriptionState is SUBSCRIPTION_STATE_ON_HOLD and the line item’s expiryTime is in the past. RTDN sends SUBSCRIPTION_ON_HOLD; the notification is a prompt to query the API, not a complete entitlement record by itself. The Play Billing client may omit held subscriptions from ordinary purchase queries, another reason a server cannot rely only on what one device currently sees.
Google’s present default recovery calculation is 60 days minus the grace-period duration, not a universal 30-day hold. Developers can adjust or disable account hold in Play Console, and Play can apply additional retry time before entry. If payment is repaired, the same purchase token recovers, SUBSCRIPTION_RECOVERED arrives, and the billing date moves to the recovery date. If the customer never repairs payment before the configured window ends, cancellation and expiration events follow.
A robust handler receives the hold RTDN, fetches subscriptionsv2, verifies the exact state and purchase identity, then suspends the mapped entitlement across every device and server surface. It can show a neutral payment-update message without claiming the customer canceled. Recovery should restore access idempotently; final expiration should remain revoked. Apple has billing retry and Billing Grace Period, but it does not name a lifecycle state “account hold,” so cross-platform models should preserve store-specific evidence rather than forcing Apple events into this Play label.
The earlier recovery phase where the subscriber remains entitled.
The collection attempts that can span grace and account hold.
The server-side access record that must be suspended during hold.