Apple y Google reportan los eventos de suscripción directamente a los servidores de Adapty — a través de App Store Server Notifications y Real-time Developer Notifications. Así es como sabes que el usuario convirtió, renovó o canceló su suscripción.

Para reenviar estos eventos, configura el destino en Adapty. Las plataformas de terceros — MMPs, analítica, mensajería — tienen cada una su propia página de integración. Tu propio backend recibe los eventos a través del webhook.

Todos los eventos comparten la misma estructura, aunque los campos dependen del tipo de evento, el store y tu configuración. Tipos de eventos y campos del webhook documenta el payload del webhook, y cada artículo de integración documenta el formato que recibe ese destino. Estados de los eventos explica cómo interpretar un estado de entrega.

Ejemplos

La mayoría de los eventos siguen las compras del usuario desde el primer cargo hasta la expiración.

El usuario cancela durante el período de prueba

El usuario activó una suscripción mensual el 1 de abril con un período de prueba de 7 días. El día 4, canceló la suscripción.

En ese caso, se enviarán los siguientes eventos:

1. trial_started el 1 de abril
2. trial_renewal_cancelled el 4 de abril
3. trial_expired el 7 de abril

El usuario cancela después de convertir

El usuario activó una suscripción mensual el 1 de abril con un período de prueba de 7 días. El décimo día, canceló la suscripción.

En ese caso, se enviarán los siguientes eventos:

1. trial_started el 1 de abril
2. trial_converted el 7 de abril
3. subscription_renewal_cancelled el 10 de abril
4. subscription_expired el 1 de mayo

Para un desglose detallado de qué eventos se activan en cada escenario, consulta los Flows de eventos.

Lista de eventos

Puedes controlar qué eventos recibe cada integración. La mayoría están disponibles para todas las integraciones, excepto tres:

• Access level updated solo se activa si la integración con webhook está configurada y el evento está habilitado. Aparece en el Event Feed y llega al webhook, pero ninguna otra integración lo recibe. Si la integración con webhook no está configurada o el tipo de evento no está habilitado, Adapty no crea el evento en absoluto y nunca aparece en el Event Feed.
• Trial still active y Subscription still active son eventos sintéticos, y solo algunas integraciones los reciben.

La siguiente tabla muestra todos los eventos que Adapty puede enviar a integraciones de terceros:

Nombre del evento	Descripción
subscription_started	Se activa cuando un usuario activa una suscripción de pago sin período de prueba, es decir, se le cobra de inmediato.
subscription_active	Confirma que la suscripción sigue activa después del evento subscription_started. Debes establecer el número de días entre el inicio de la suscripción y esta comprobación. El evento llega si la suscripción sigue activa, incluso cuando el usuario está en un período de gracia. Si la suscripción ha finalizado o el usuario desactivó la renovación automática, no llega nada y Adapty no vuelve a comprobarlo. Este evento solo sigue a las suscripciones compradas sin período de prueba. Una prueba que se convierte envía trial_converted, que no inicia la comprobación.
subscription_renewed	Ocurre cuando se renueva una suscripción y se cobra al usuario. Este evento comienza a partir de la segunda facturación, ya sea en una suscripción con o sin período de prueba.
subscription_renewal_cancelled	Un usuario ha desactivado la renovación automática de la suscripción. El usuario conserva el acceso a las funciones premium hasta el final del período de suscripción pagado.
subscription_renewal_reactivated	Se activa cuando un usuario reactiva la renovación automática de la suscripción.
subscription_expired	Se activa cuando una suscripción finaliza por completo tras ser cancelada. Por ejemplo, si un usuario cancela una suscripción el 12 de diciembre pero esta sigue activa hasta el 31 de diciembre, el evento se registra el 31 de diciembre cuando la suscripción expira.
subscription_paused	Ocurre cuando un usuario activa la pausa de suscripción (solo Android).
subscription_deferred	Se activa cuando una compra de suscripción se aplaza, lo que permite a los usuarios retrasar el pago mientras mantienen el acceso a las funciones premium. Esta función está disponible a través de la API de Google Play Developer y puede usarse para períodos de prueba gratuitos o para ayudar a usuarios con dificultades económicas.
non_subscription_purchase	Cualquier compra que no sea una suscripción, como el acceso de por vida o productos consumibles como monedas del juego.
trial_started	Se activa cuando un usuario activa una suscripción de prueba.
trial_active	Confirma que la prueba sigue activa después del evento trial_started. Debes establecer el número de días entre el inicio de la prueba y esta comprobación. El evento llega si la prueba sigue en curso. Si la prueba ha finalizado o se ha convertido, o el usuario desactivó la renovación automática, no llega nada y Adapty no vuelve a comprobarlo.
trial_converted	Ocurre cuando finaliza una prueba y se cobra al usuario (primera compra). Por ejemplo, si un usuario tiene una prueba hasta el 14 de enero pero se le cobra el 7 de enero, este evento se registra el 7 de enero.
trial_renewal_cancelled	Un usuario desactivó la renovación automática de la suscripción durante el período de prueba. El usuario conserva el acceso a las funciones premium hasta que finalice la prueba, pero no se le cobrará ni iniciará una suscripción.
trial_renewal_reactivated	Ocurre cuando un usuario reactiva la renovación automática de la suscripción durante el período de prueba.
trial_expired	Se activa cuando una prueba finaliza sin convertirse en una suscripción.
entered_grace_period	Ocurre cuando un intento de pago falla y el usuario entra en un período de gracia (si está habilitado). El usuario conserva el acceso premium durante este tiempo.
billing_issue_detected	Se activa cuando ocurre un problema de facturación durante un intento de cobro (p. ej., saldo insuficiente en la tarjeta).
subscription_refunded	Se activa cuando se reembolsa una suscripción (p. ej., por parte del soporte de Apple).
non_subscription_purchase_refunded	Se activa cuando se reembolsa una compra que no es una suscripción.
access_level_updated	Ocurre cuando se actualiza el nivel de acceso de un usuario.

Eventos sintéticos

La mayoría de los eventos se activan por un cambio: una compra, una renovación, una cancelación. Los eventos Trial still active y Subscription still active son lo contrario. Tú estableces un temporizador. Cuando expira, Adapty comprueba el estado del trial o la suscripción. Si el trial o la suscripción no ha terminado, Adapty lanza el evento correspondiente.

Estos eventos sintéticos están disponibles para Adjust, Amplitude, AppMetrica, AppsFlyer, Branch, Facebook Analytics, Firebase, Mixpanel, OneSignal, PostHog, Singular, SplitMetrics y el webhook. Debes activarlos manualmente.

Si el usuario desactiva la renovación automática antes de que expire el temporizador, Adapty omite el envío. Cuenta al usuario como perdido, aunque su acceso se mantenga hasta el final del período pagado.

Desactivar el evento impide que Adapty inicie nuevos temporizadores. Los temporizadores que ya están en marcha siguen enviando cuando expiran, por lo que un destino puede seguir recibiendo el evento durante el tiempo que dure el retraso que hayas configurado.

La prueba sigue activa

• Integración: AppsFlyer
• Evento: Trial still active
• Demora: 3 días
• Inicio de la prueba: 1 de abril
• Fin de la prueba: 7 de abril

AppsFlyer recibe:

1. trial_started el 1 de abril
2. trial_active el 4 de abril
3. trial_converted el 7 de abril

Ten en cuenta lo siguiente:

• Al tratarse de una prueba convertida, nunca recibirás el evento subscription_active.
• Si la demora se hubiera configurado a 7 días, trial_active nunca llegaría. Para ese momento, el usuario ya habría convertido.

La suscripción sigue activa

• Integración: Webhook
• Evento: Suscripción activa
• Retraso: 7 días
• Inicio de la suscripción: 1 de abril, sin período de prueba
• Renovación: 1 de mayo

El webhook recibe:

1. subscription_started el 1 de abril
2. subscription_active el 8 de abril
3. subscription_renewed el 1 de mayo