SubmetryBlog

Periodo de gracia y reintentos de cobro en App Store: qué medir tras un fallo

Distingue el acceso de la suscripción y el cobro recuperado, prueba los estados en el entorno sandbox de Apple y compara cohortes completas.

Un reloj de arena junto a una tarjeta sin texto, con caminos luminosos hacia un símbolo de reintento y una marca de verificación.

Cuando falla la renovación de una suscripción de App Store, hay dos preguntas distintas. ¿Se llegó a cobrar la renovación? ¿Tuvo acceso la persona mientras se intentaba resolver el pago? Si ambas respuestas quedan en un solo estado, puedes retirar el acceso demasiado pronto o dar por recuperada una renovación todavía pendiente.

1. Separa el reintento de cobro del acceso

El reintento de cobro, o Billing Retry, indica que App Store sigue intentando cobrar una renovación automática después de un fallo. El periodo de gracia de facturación, o Billing Grace Period, es una configuración de App Store Connect. Si se aplica a la suscripción, permite conservar el acceso durante ese plazo sin que el cobro esté confirmado. Al acabar el plazo, el acceso puede caducar aunque Apple siga intentando cobrar. Consulta la guía de Apple sobre el periodo de gracia.

Imagina que el cobro falla el lunes, el acceso se mantiene unos días y caduca antes de que se confirme la renovación. Has recuperado el cobro más tarde, pero la persona estuvo un tiempo sin acceso. No es el mismo resultado que un cobro recuperado durante el periodo de gracia. Registra por separado el primer fallo, el fin del periodo de gracia, el cambio real de acceso y la renovación confirmada.

2. No hagas depender el acceso del último webhook recibido

En los flujos de webhooks de RevenueCat, un problema de facturación puede generar BILLING_ISSUE y CANCELLATION con motivo BILLING_ERROR. Ese motivo no indica que la persona cancelara voluntariamente. Además, el orden de llegada de las notificaciones no siempre coincide con el orden de los hechos. Para decidir si hay acceso, consulta el estado verificado que uses como fuente de referencia.

Guarda el identificador del evento y su relación con la suscripción, junto con la fecha del evento y la de recepción. Procesa los duplicados sin volver a sumar renovaciones ni conceder acceso otra vez. Si recibes tarde una notificación, no dejes que sustituya por sí sola un estado posterior ya confirmado. Cuando el evento y el estado no coincidan, vuelve a consultar la fuente antes de actuar.

3. Reproduce los escenarios en sandbox

Usa el entorno sandbox de Apple para simular una renovación fallida. Prueba un cobro que se recupera durante la gracia, otro que se recupera después de que caduque el acceso y otro que no se recupera dentro del plazo de observación. La guía de pruebas de StoreKit describe cómo simular problemas de facturación. Los tiempos de prueba no representan los de producción.

Comprueba tanto lo que ve el usuario en la app como el estado que guarda el servidor. Repite también una notificación y entrega otra con retraso para verificar que el resultado y los recuentos no se alteren por la forma en que llegaron los eventos.

4. Compara cohortes con tiempo suficiente para observar el resultado

Agrupa las renovaciones por la fecha del primer fallo y cuenta cada episodio una sola vez, no cada intento de cobro. Fija de antemano un plazo de observación y compara solo cohortes que hayan completado ese plazo. Las más recientes pueden seguir abiertas. No las clasifiques como pérdidas definitivas.

Distingue tres resultados: cobro recuperado sin interrupción, cobro recuperado después de perder el acceso y cobro no confirmado dentro del plazo. Así puedes entender qué pasó con el pago y con la experiencia del cliente. Si mejora la recuperación, no atribuyas por defecto ese cambio al periodo de gracia: también pueden haber cambiado el público o las condiciones de facturación.

Consulta la guía de Submetry sobre cancelación y vencimiento para definir tu métrica.

Conoce Submetry y apúntate a la lista de espera del lanzamiento.