Cómo reducir el churn en Google Play: periodo de gracia y suspensión de la cuenta
Cómo funcionan el periodo de gracia y la suspensión de la cuenta en Google Play, qué notificaciones tratar, mensajes en la app y cómo recuperar usuarios.

En Google Play, Google cobra al cliente, reintenta los pagos fallidos y muestra el botón de cancelar. No puedes reintentar un cargo ni tocar el método de pago del cliente. Lo que sí controlas: cuánto duran el periodo de gracia y la suspensión de la cuenta, si el cliente conserva el acceso, qué le muestra tu app y lo rápido que reaccionas cuando una suscripción se recupera o termina.
Esta guía cubre el periodo de gracia, la suspensión de la cuenta, las notificaciones de desarrollador en tiempo real (RTDN) y los estados de subscriptionsv2 que hay detrás, los mensajes en la app para los pagos rechazados, los deep links al centro de suscripciones, la restauración y la nueva suscripción, y las compras anuladas. Se ciñe a la documentación de Google: el ciclo de vida de las suscripciones, sobre las suscripciones, la referencia de RTDN y Help Google dispute chargebacks (todas consultadas en noviembre de 2026).
Qué hace Google cuando falla una renovación
Cuando falla un pago de renovación, Google avisa al usuario y sigue intentando renovar durante un tiempo antes de que termine la suscripción. La documentación de Google lo llama periodo de recuperación, formado por un periodo de gracia seguido de una suspensión de la cuenta (account hold). Durante ese tiempo, Google envía al usuario correos y notificaciones pidiéndole que actualice su método de pago.
| Fase | Acceso del usuario | subscriptionState |
RTDN al empezar |
|---|---|---|---|
| Periodo de gracia | Conserva el acceso | SUBSCRIPTION_STATE_IN_GRACE_PERIOD |
SUBSCRIPTION_IN_GRACE_PERIOD (6) |
| Suspensión de la cuenta | Pierde el acceso | SUBSCRIPTION_STATE_ON_HOLD |
SUBSCRIPTION_ON_HOLD (5) |
| Recuperada | Acceso restablecido | SUBSCRIPTION_STATE_ACTIVE |
SUBSCRIPTION_RECOVERED (1) |
| No recuperada | Acceso terminado | SUBSCRIPTION_STATE_CANCELED, luego EXPIRED |
SUBSCRIPTION_CANCELED (3), luego SUBSCRIPTION_EXPIRED (13) |
Periodo de gracia
La guía del ciclo de vida de Google dice:
- El periodo de gracia está activado por defecto en todos los planes base de renovación automática. Puedes cambiar su duración o desactivarlo en Play Console, y Google advierte de que una duración más corta puede reducir el número de suscripciones recuperadas.
- Durante el periodo de gracia el usuario debe conservar el acceso.
autoRenewEnabledsigue entruey Google amplíaexpiryTimehasta que termina el periodo de gracia. - Si el usuario arregla su método de pago, la suscripción se renueva con su fecha de renovación original.
- Cambiar la duración del periodo de gracia solo afecta a las renovaciones que entran en el periodo de gracia después del cambio.
- Si fijas 0 días, Google espera al menos 1 día (un “periodo de gracia silencioso”) para dar tiempo a los reintentos. La suscripción sigue activa durante esas 24 horas y no recibirás una RTDN de periodo de gracia.
Si tu app solo usa queryPurchasesAsync() para comprobar los derechos de acceso, los periodos de gracia se gestionan por ti, porque Play Billing Library sigue devolviendo esas compras como activas.
Suspensión de la cuenta
La suspensión de la cuenta sigue al periodo de gracia:
- Está activada por defecto, y su duración por defecto es de 60 días menos el periodo de gracia. Puedes cambiarla o desactivarla en Play Console, con la misma advertencia sobre las duraciones más cortas.
- Antes de que la suscripción entre en suspensión, Google hace intentos de cobro adicionales durante un máximo de 48 horas, mientras el usuario conserva el acceso.
- Durante la suspensión debes bloquear el acceso.
expiryTimeestá en el pasado yqueryPurchasesAsync()ya no devuelve la suscripción. - Si el usuario arregla su pago, recibes
SUBSCRIPTION_RECOVERED, el token de compra sigue siendo el mismo y debes restablecer el acceso. A diferencia de la recuperación durante el periodo de gracia, la fecha de facturación pasa a la fecha de recuperación. - Si la suspensión termina sin arreglo, recibes
SUBSCRIPTION_CANCELEDy luegoSUBSCRIPTION_EXPIRED. - Una suscripción en pausa que se reanuda con un método de pago que falla pasa directamente a la suspensión de la cuenta.
Google también señala que los usuarios pueden cancelar, restaurar o volver a comprar durante la suspensión, así que tu backend debe seguir tratando esos eventos.
Notificaciones de desarrollador en tiempo real
Las RTDN se entregan a través de Cloud Pub/Sub y solo llevan el tipo de notificación y el token de compra. La recomendación de Google es llamar a purchases.subscriptionsv2.get desde tu backend con cada notificación para leer el estado completo. La referencia de RTDN enumera los tipos de suscripción; los que más importan para el churn:
| Código | Tipo | Qué hacer |
|---|---|---|
| 6 | SUBSCRIPTION_IN_GRACE_PERIOD |
Mantener el acceso; pedir al usuario que arregle su pago |
| 5 | SUBSCRIPTION_ON_HOLD |
Retirar el acceso; decirle al usuario por qué |
| 1 | SUBSCRIPTION_RECOVERED |
Restablecer el acceso (también se envía cuando una suscripción se reanuda tras una pausa) |
| 2 | SUBSCRIPTION_RENEWED |
Renovación normal |
| 3 | SUBSCRIPTION_CANCELED |
Cancelación voluntaria o involuntaria; revisar canceledStateContext |
| 7 | SUBSCRIPTION_RESTARTED |
El usuario restauró una suscripción cancelada aún no caducada |
| 12 | SUBSCRIPTION_REVOKED |
Revocada antes de caducar, por ejemplo tras un contracargo; retirar el acceso |
| 13 | SUBSCRIPTION_EXPIRED |
Retirar el acceso |
| 4 | SUBSCRIPTION_PURCHASED |
Nueva compra, incluida una nueva suscripción |
En una cancelación, canceledStateContext te dice si canceló el usuario, el sistema o tú, y en las cancelaciones del usuario userInitiatedCancellation puede incluir el motivo que dio. Úsalo: una cancelación tras la suspensión de la cuenta es un problema de pago, no una decisión de irse.
Mensajes en la app para los pagos rechazados
Google ofrece un mensaje listo para usar para los problemas de pago. Si llamas a BillingClient.showInAppMessages() con InAppMessageCategoryId.TRANSACTIONAL, Google Play muestra una barra temporal (snackbar) que dice al usuario que su pago fue rechazado, con un deep link para arreglar su método de pago en Google Play. Según la guía de suscripciones de Google, el mensaje se muestra una vez al día durante el periodo de gracia y la suspensión de la cuenta, y Google recomienda llamar a la API cada vez que el usuario abre la app.
Si el usuario arregla su pago, la llamada devuelve SUBSCRIPTION_STATUS_UPDATED con un token de compra. Actualiza la suscripción desde tu backend y restablece el acceso de inmediato.
Para los usuarios que acceden a tu contenido fuera de la app (en la web, por ejemplo), Google sugiere una notificación push o un correo cuando el acceso se detiene por la suspensión de la cuenta.
Deep links al centro de suscripciones
Tu app debe enlazar a la gestión de suscripciones desde su pantalla de ajustes. Google documenta dos URL:
- Todas las suscripciones:
https://play.google.com/store/account/subscriptions - Una suscripción (recomendado):
https://play.google.com/store/account/subscriptions?sku=your-sub-product-id&package=your-app-package
La segunda abre la página de gestión de esa suscripción, donde el usuario puede gestionar sus métodos de pago, cancelar, volver a suscribirse o pausar. Úsala también en tus propios correos de pago.
Restaurar, volver a suscribirse y win-back
Google separa dos acciones, ambas mostradas al usuario como un botón Resubscribe en Play Store:
- Restaurar: antes de la caducidad, una suscripción cancelada se restaura y sigue renovándose como si nunca se hubiera cancelado. Conserva el mismo token de compra y recibes
SUBSCRIPTION_RESTARTED. Google dice que todas las apps deben admitir la restauración. - Volver a suscribirse: tras la caducidad, si el plan base lo permite, el usuario vuelve a comprar desde Play Store. Es una nueva compra con un token nuevo y una RTDN
SUBSCRIPTION_PURCHASED. Debes confirmarla (acknowledge); el campooutOfAppPurchaseContextte ayuda a vincularla con la suscripción y el usuario anteriores.
Dentro de tu app, la guía de Google describe cómo recuperar a los usuarios que cancelaron ofreciéndoles una pantalla para volver a suscribirse (por ejemplo con un botón Reactivar), antes o después de la caducidad. Las ofertas de suscripción pueden dirigirse a los usuarios que cumplan los requisitos con descuentos; las reglas de elegibilidad se fijan en Play Console.
Reembolsos, compras anuladas y contracargos
Cuando una compra se reembolsa o es objeto de un contracargo, queda anulada. Recibes una RTDN voidedPurchaseNotification con el token de compra, el ID del pedido, productType y refundType (reembolso total o reembolso parcial por cantidad). La guía del ciclo de vida de Google añade que una suscripción con contracargo, o revocada por tu backend con purchases.subscriptionsv2.revoke, desencadena SUBSCRIPTION_REVOKED, y debes retirar el acceso. La Voided Purchases API te da más detalle sobre un intervalo de tiempo.
En los contracargos, Google te deja opinar. Cuando un contracargo necesita la revisión del desarrollador, Google Play envía una RTDN PendingRefundReviewNotification, y tienes 24 horas para responder con la ReviewRefund API, dando una preferencia de reembolso y cualquier prueba de uso de la compra. Google solo registra tu primera llamada.
Una lista de control
- Las RTDN llegan a tu backend, y cada una desencadena un
subscriptionsv2.get. - El periodo de gracia y la suspensión de la cuenta están activados, con duraciones elegidas a propósito.
- El acceso se mantiene durante el periodo de gracia y se detiene durante la suspensión.
-
showInAppMessages()se llama al abrir la app. - Tu pantalla de ajustes y tus correos usan el deep link de la suscripción concreta.
- Las compras de restauración y de nueva suscripción se tratan y se confirman.
- Cada compra lleva un ID de cuenta ofuscado, para poder asociarla a tu usuario.
- Se tratan las compras anuladas y las notificaciones de revisión de contracargos.
Hacerlo con NoChurn
Google conserva los pagos, los reintentos, el periodo de gracia, la suspensión de la cuenta y el botón de cancelar; NoChurn no cambia eso. NoChurn lee tus notificaciones de desarrollador en tiempo real, asocia cada suscripción a tu usuario mediante el ID de cuenta ofuscado y pone los periodos de gracia, las suspensiones, las cancelaciones, las recuperaciones y las compras anuladas en la cronología del cliente y en una puntuación de churn de 0 a 100. Donde Google lo permite, actúa: mensajes en tu app o por correo que enlazan a la página de la suscripción en Play, un flujo de cancelación que tu app muestra mediante la API headless antes de enlazar a Google Play, y correos de win-back a los días 30, 60 y 90 según el motivo de cancelación. Consulta NoChurn + Google Play.