Cómo medir el churn en Chargebee
Medir el churn con los datos de Chargebee: qué estados y eventos cuentan, churn voluntario e involuntario, reason codes, pausas y un cálculo mensual.

El churn parece una sola cifra, pero en Chargebee está repartido entre varios estados, eventos y ajustes. Una suscripción puede tener una cancelación programada y seguir activa. Puede estar en pausa y no pagar nada. Puede cancelarse por impago y no por decisión del cliente. Salvo que decidas de antemano cómo cuenta cada caso, dos personas de tu equipo calcularán dos tasas de churn distintas con los mismos datos.
Esta guía muestra cómo construir una medición clara del churn a partir de Chargebee Billing: qué estados y eventos usar, cómo separar el churn voluntario del involuntario y cómo tratar las pausas y las reactivaciones. Se ciñe a la documentación de Chargebee: Subscription Cancellation, la API Cancel a subscription, los tipos de eventos, las API List events y List subscriptions, Reason Codes y Pause Subscription (todo consultado en noviembre de 2026).
Empieza por los informes de Chargebee
Chargebee tiene informes integrados, entre ellos un informe estándar de suscripciones. Úsalo primero, y lee en esa página cómo se define cada cifra antes de compararla con cualquier otra cosa. Esta guía se centra en construir tu propia medición a partir de los datos de Chargebee, algo que necesitas cuando quieres cruzar el churn con el uso del producto, el origen del registro o los motivos de cancelación en tu propio data warehouse.
Los estados que importan
| Estado de Chargebee | ¿Perdido? | Por qué |
|---|---|---|
in_trial |
Todavía no es un cliente de pago | Mide la conversión de las pruebas por separado |
active |
No | Paga |
non_renewing |
Todavía no | Cancelación programada para el final del plazo; sigue activa |
paused |
No, pero no paga | Síguela por separado |
cancelled |
Sí | Terminada |
La fila non_renewing es la que los equipos se equivocan. Según la API Cancel a subscription, una cancelación al final del plazo pasa la suscripción a non_renewing y fija sus ciclos de facturación restantes en 0. Todavía se puede salvar con «Remove scheduled cancellation». Cuéntala como churn en la fecha en que pasa a cancelled, no el día en que el cliente hizo clic.
Los eventos que importan
Los tipos de eventos de Chargebee te dan un registro con fecha y hora de cada transición:
| Evento | Úsalo para |
|---|---|
subscription_created |
Nuevas suscripciones |
subscription_cancellation_scheduled |
Cancelaciones programadas (indicador adelantado) |
subscription_cancellation_reminder |
Enviado 6 días antes de una cancelación programada |
subscription_cancelled |
Churn, en su fecha efectiva |
subscription_reactivated |
Clientes que volvieron después de cancelar |
subscription_paused, subscription_resumed |
Periodos de pausa |
subscription_pause_scheduled |
Pausas programadas para más adelante |
Puedes recibirlos como webhooks u obtener el historial mediante la API List events. Para un primer análisis, descargar los eventos de los últimos doce meses suele ser la forma más rápida de tener una base.
Una nota sobre la ortografía: la referencia de eventos de Chargebee usa subscription_cancelled con dos L, mientras que algunas de sus otras páginas escriben «canceled». Usa la cadena exacta que ves en tus propios payloads.
Churn voluntario frente a involuntario
Necesitan soluciones distintas, así que sepáralos desde el primer día.
- Involuntario: la referencia de tipos de eventos dice que
subscription_cancelledlleva uncancel_reasoncuando la cancelación se debió a un impago o a la falta de una tarjeta. Esas son tus pérdidas por pagos fallidos. - Voluntario: las cancelaciones sin ese motivo del sistema, que suelen llevar un
cancel_reason_codede tus Reason Codes configurados.
Haz obligatorios los reason codes para las cancelaciones desde la app y el portal. Según la documentación de Chargebee, cuando los reason codes son obligatorios, la API de cancelación también debe recibir un cancel_reason_code. Así cada cancelación voluntaria tiene un motivo, y puedes informar del churn por motivo sin conjeturas.
Un punto práctico de la documentación de cancelación: cancel_reason_code puede no incluirse cuando obtienes una suscripción non-renewing salvo que actives el ajuste correspondiente a nivel de sitio. Actívalo, o captura el motivo desde el evento subscription_cancellation_scheduled.
Pausas
La página Pause Subscription de Chargebee dice que las renovaciones se detienen mientras una suscripción está en pausa. Un cliente en pausa no paga y no se ha ido.
Elige una regla y mantenla:
- Excluye las suscripciones en pausa de la base inicial y del churn, e indica el número de pausas junto a la tasa de churn. Es la opción más habitual.
- Si una pausa termina en una cancelación, cuenta el churn en la fecha de la cancelación como cualquier otro.
Elijas lo que elijas, no dejes que las pausas bajen en silencio tu tasa de churn. Una oferta de pausa que solo retrasa la cancelación debería acabar apareciendo como churn.
Reactivaciones
Un cliente que cancela y después se reactiva (subscription_reactivated) sigue siendo churn el mes en que se fue. Cuenta la reactivación por separado, como clientes recuperados o reactivados, en lugar de restarla del churn pasado. Reescribir los meses pasados hace que las tendencias sean imposibles de leer.
Un cálculo de churn mensual
Con los estados y eventos anteriores, una tasa de churn de clientes para un mes:
- Base inicial: suscripciones
activeonon_renewinga las 00:00 del primer día del mes (excluyein_trial, ypausedsi esa es tu regla). La API List subscriptions te da el estado actual; para una fecha pasada, reconstruye el estado a partir de los eventos. - Perdidas: las suscripciones de esa base con un evento
subscription_cancelleddurante el mes. - Tasa de churn de clientes: perdidas divididas entre la base inicial.
- División: el mismo ratio para el involuntario (
cancel_reasondel sistema) y el voluntario (concancel_reason_code), que suman el total.
Las nuevas suscripciones creadas durante el mes no están en la base inicial, así que sus cancelaciones dentro del mes se informan por separado o se dejan fuera. Deja por escrito cuál de las dos.
Para el churn de ingresos, sustituye los recuentos por el importe recurrente mensual de cada suscripción a principio de mes (los planes anuales divididos entre 12). Informa de la contracción por downgrades por separado de las cancelaciones.
Indicadores adelantados
El churn es una cifra retrasada. Estas se mueven antes:
- Cancelaciones programadas (
subscription_cancellation_scheduled) este mes, sobre todo en los planes anuales. - Retenciones de non-renewing: suscripciones que salen de
non_renewingsin cancelarse. - Renovaciones fallidas que todavía no se han recuperado.
- Pausas iniciadas, y la proporción de pausas que terminan en cancelación.
Errores habituales
- Contar el churn en el clic. La fecha de cancelación es cuando la suscripción pasa a
cancelled, no cuando pasó anon_renewing. - Mezclar las pruebas en la base. Las pruebas que no se convierten son un problema de conversión, no churn.
- Una sola cifra combinada. Sin la división entre voluntario e involuntario, no puedes saber si arreglar tu dunning o tu producto.
- Pausas silenciosas. Excluir las suscripciones en pausa sin informar de ellas oculta un grupo creciente de clientes que no pagan.
Mantén estables las definiciones
Deja por escrito tus definiciones: qué cuenta como base, en qué fecha se registra el churn, cómo se tratan las pausas, las pruebas, las reactivaciones y los plazos contractuales. Cámbialas pocas veces y, cuando lo hagas, recalcula el historial. Una tasa de churn es útil sobre todo comparada consigo misma.
Hacerlo con NoChurn
Las suscripciones, las cancelaciones y los informes propios de Chargebee siguen en Chargebee. NoChurn lee tus eventos de Chargebee, separa el churn voluntario del involuntario, registra el motivo de su flujo de cancelación (donde cancelar está siempre a un clic) y da a cada cliente un churn score de 0 a 100. Puedes enviar tus propios datos de producto por API para ver qué atributos se correlacionan con el churn y, si conectas un help desk, las conversaciones de soporte se leen para el score y los insights. Consulta NoChurn + Chargebee.