Cómo reducir el churn involuntario en el App Store: billing retry y periodo de gracia
Cómo funcionan el billing retry y el Billing Grace Period del App Store, qué notificaciones gestionar, qué puede hacer tu app y las ofertas de win-back.

En el App Store, Apple cobra al cliente, Apple reintenta el pago y Apple es dueña del botón de cancelar. No puedes reintentar un cargo, cambiar la tarjeta de un cliente ni ver su dirección de correo. Eso no significa que no puedas hacer nada: lo que controlas es cuánto tiempo conserva el cliente el acceso, qué le dice tu app y cómo reaccionas a cada notificación.
Esta guía cubre el billing retry, el Billing Grace Period, las App Store Server Notifications V2 que te cuentan lo que ha pasado, lo que tu app puede hacer, las ofertas de win-back y las solicitudes de reembolso. Se ciñe a la documentación de Apple: Reducing involuntary subscriber churn, Enable Billing Grace Period, la referencia de notificationType, el mensaje billingIssue, Supporting win-back offers in your app y Send Consumption Information (todo consultado en noviembre de 2026).
Qué hace Apple cuando falla una renovación
Cuando una renovación falla por un problema de facturación, la suscripción entra en el estado de billing retry. La documentación de Apple dice que el App Store intenta entonces cobrar durante un máximo de 60 días.
- Si Apple recupera el pago durante el billing retry, la suscripción se renueva. Sin periodo de gracia, la nueva fecha de facturación es la fecha de la recuperación, así que las renovaciones siguientes se desplazan.
- Si el periodo de billing retry termina sin éxito, la suscripción caduca.
No eliges el calendario de reintentos y no puedes provocar un reintento. Apple sí dice que cuando el cliente actualiza su información de pago, el App Store intenta renovar de inmediato. Así que lo más útil que puedes hacer es conseguir que el cliente arregle su medio de pago.
Billing Grace Period
Por defecto, un cliente en billing retry pierde el acceso. El Billing Grace Period le permite conservar el acceso completo durante un tiempo mientras Apple intenta cobrar. Se activa en App Store Connect, en la sección Subscriptions de tu app. Según la página de ayuda de Apple:
| Periodo de gracia elegido | Suscripciones semanales | Suscripciones mensuales y anuales |
|---|---|---|
| 3 días | 3 días | 3 días |
| 16 días | 6 días | 16 días |
| 28 días | 6 días | 28 días |
Otros puntos de la misma página:
- El ajuste se aplica a todas las suscripciones con renovación automática de la app; no se puede fijar por producto.
- Eliges si se aplica a todas las renovaciones (incluidas las pruebas gratuitas y las ofertas gratuitas que pasan a pago) o solo a las renovaciones de pago a pago.
- Puedes activarlo primero solo en sandbox y después en producción.
- Los cambios pueden tardar hasta 24 horas y solo se aplican a las próximas renovaciones.
- No se aplica a las suscripciones mensuales con un compromiso de 12 meses.
- Tu app debe seguir comprobando el estado de renovación y dar el servicio completo durante el periodo de gracia.
La diferencia importa para los ingresos: si Apple recupera el pago dentro del periodo de gracia, los días de servicio pagado del cliente y tus ingresos no se interrumpen, y la suscripción mantiene su fecha de facturación original. Una recuperación después del periodo de gracia, pero aún dentro del billing retry, se renueva en la fecha de la recuperación.
Las notificaciones que hay que gestionar
Las App Store Server Notifications V2 informan a tu servidor de cada paso. La referencia de notificationType lista estos eventos de facturación:
| Evento | notificationType |
subtype |
|---|---|---|
| La renovación falla, la suscripción entra en billing retry | DID_FAIL_TO_RENEW |
ninguno |
| La renovación falla, billing retry con Billing Grace Period | DID_FAIL_TO_RENEW |
GRACE_PERIOD |
| La suscripción sale del periodo de gracia (el billing retry continúa) | GRACE_PERIOD_EXPIRED |
ninguno |
| El billing retry recupera la suscripción | DID_RENEW |
BILLING_RECOVERY |
| El billing retry termina sin recuperación | EXPIRED |
BILLING_RETRY |
| El cliente desactiva la renovación automática | DID_CHANGE_RENEWAL_STATUS |
AUTO_RENEW_DISABLED |
| El cliente vuelve a activar la renovación automática | DID_CHANGE_RENEWAL_STATUS |
AUTO_RENEW_ENABLED |
| La suscripción caduca después de que el cliente cancelara | EXPIRED |
VOLUNTARY |
Ten en cuenta que GRACE_PERIOD_EXPIRED no significa que el cliente se haya ido. Apple sigue intentándolo; tú simplemente dejas de dar acceso.
También puedes pedir el estado actual con el endpoint Get All Subscription Statuses de la App Store Server API. Su campo status vale 1 (activa), 2 (caducada), 3 (billing retry), 4 (Billing Grace Period) o 5 (revocada). La información de renovación también incluye isInBillingRetryPeriod, gracePeriodExpiresDate y un expirationIntent, donde 2 significa un error de facturación y 1 que el cliente canceló.
Trata AUTO_RENEW_DISABLED como un aviso temprano
DID_CHANGE_RENEWAL_STATUS con AUTO_RENEW_DISABLED es lo más parecido a una cancelación en el App Store: el cliente conserva el acceso hasta el final del periodo, pero no renovará. No es un fallo de pago, pero es el mejor momento para un mensaje de retención, porque la suscripción sigue activa.
Qué puede hacer tu app
Apple es explícita sobre las herramientas que tienes.
- Deja que StoreKit muestre el mensaje de facturación. Cuando una suscripción está en billing retry, el App Store envía un mensaje
billingIssue. StoreKit muestra una hoja Billing Problem cuando se abre tu app (o cuando se lo pides), y el cliente puede arreglar su medio de pago sin salir de tu app. Apple documenta la frecuencia: cada 24 horas los días 1 a 3, cada 72 horas los días 4 a 16, cada 96 horas los días 17 a 30 y cada 120 horas los días 31 a 60. Puedes retrasarlo o suprimirlo, pero si no tienes un mensaje mejor, deja que se muestre. - Muestra tu propio mensaje en la app. La guía de Apple sobre el churn involuntario dice que tu app puede decir a los usuarios que pueden evitar perder el acceso resolviendo su error de facturación, y puede enlazar directamente a la página Manage Payments de su cuenta. Comprueba primero
expirationIntent, para no mostrar un mensaje de facturación a alguien que canceló. - Enlaza a la gestión de la suscripción.
showManageSubscriptions(in:)(omanageSubscriptionsSheeten SwiftUI) abre la misma hoja que Ajustes, donde el cliente puede ver, cambiar o cancelar su suscripción. - Contacta con el cliente por tus propios canales. Si el cliente tiene una cuenta contigo y te dio un correo, puedes escribirle. Apple no comparte el correo del cliente, así que tienes que asociar la transacción del App Store a tu propio usuario, por ejemplo con un
appAccountTokenfijado en la compra. - Restablece el acceso rápido. Tras una recuperación, StoreKit añade la transacción de renovación a la cola. Apple señala que si tu app ya está abierta, puede que no se llame al observer y la app se entere en el siguiente arranque. Tu servidor suele saberlo antes por
DID_RENEW.
Lo que no puedes hacer: reintentar el cargo, cambiar tú mismo el medio de pago, ampliar el billing retry ni quitar la opción de cancelar de Apple.
Ofertas de win-back
Cuando una suscripción se ha perdido (fecha de caducidad en el pasado y renovación automática desactivada), Apple te permite proponer una oferta de win-back: un periodo gratuito o con descuento para antiguos suscriptores que cumplan los requisitos. Según la guía de Apple:
- Configuras las ofertas y las reglas de elegibilidad en App Store Connect: duración de la suscripción pagada, tiempo desde la caducidad y tiempo entre ofertas canjeadas.
- Los clientes pueden encontrarlas en el App Store, en los ajustes de suscripción de su cuenta y en tu app, donde StoreKit puede mostrar por defecto una hoja de oferta de win-back.
- App Store Connect da a cada oferta un enlace directo que puedes enviar por tus propios canales, como el correo. Antes de enviarlo, llama a Get All Subscription Statuses y comprueba el array
eligibleWinBackOfferIds, y envía el enlace solo a los clientes elegibles. - Un canje después de la caducidad produce
SUBSCRIBEDcon el subtipoRESUBSCRIBE; las transacciones canjeadas con una oferta de win-back tienenofferType4.
Para los suscriptores activos, las promotional offers y los offer codes de Apple son las herramientas equivalentes (el canje envía OFFER_REDEEMED).
Solicitudes de reembolso y CONSUMPTION_REQUEST
Los clientes piden los reembolsos a Apple, no a ti, y Apple decide. Cuando un cliente solicita un reembolso, el App Store envía una notificación CONSUMPTION_REQUEST. Si el cliente consintió compartir sus datos con Apple, puedes responder con el endpoint Send Consumption Information en 12 horas. Apple dice que usa esta información para fundamentar sus decisiones de reembolso. Eres responsable de obtener un consentimiento válido, y Apple dice que no uses para ello el aviso de App Tracking Transparency. Si no tienes consentimiento, no respondas.
Cuando Apple reembolsa, recibes REFUND; cuando rechaza un reembolso solicitado desde tu app, REFUND_DECLINED; y si un reembolso se revierte, REFUND_REVERSED.
Una checklist
- Las App Store Server Notifications V2 están activadas y tu servidor gestiona los eventos de facturación de arriba.
- El Billing Grace Period está activado, probado en sandbox y después activado en producción.
- Tu app da acceso durante el periodo de gracia y lo retira con
GRACE_PERIOD_EXPIRED. - Se deja que se muestre el mensaje de facturación de StoreKit, o se sustituye por el tuyo.
- Tu pantalla de ajustes enlaza a la gestión de la suscripción.
- Cada compra lleva un
appAccountToken, para que puedas contactar con el cliente. - Las ofertas de win-back están configuradas y solo se envían a clientes elegibles.
- Las solicitudes de consumo se responden en 12 horas cuando el cliente ha dado su consentimiento.
Hacerlo con NoChurn
Apple se queda con los pagos, los reintentos, el periodo de gracia y el botón de cancelar; NoChurn no cambia eso. NoChurn lee tus App Store Server Notifications, asocia cada suscripción a tu usuario mediante el appAccountToken y lleva los problemas de facturación, los cambios de renovación automática y los reembolsos a la cronología del cliente y a un churn score de 0 a 100. Donde Apple lo permite, actúa: mensajes en tu app o por correo que enlazan a los ajustes de suscripción de Apple, un flujo de cancelación que tu app muestra mediante la API headless antes de enlazar a Apple, correos de win-back a los 30, 60 y 90 días según el motivo de cancelación, y respuestas a las solicitudes de consumo a partir de tus propios datos de uso. Consulta NoChurn + App Store.