FLUJOS DE CANCELACIÓNCHARGEBEE

Cómo añadir un flujo de cancelación a Chargebee

Un flujo de cancelación en Chargebee: ajustes del portal, reason codes, la API de cancelación, cancelaciones programadas y ofertas justas.

Publicado el 6 min de lectura

Cómo añadir un flujo de cancelación a Chargebee

Chargebee te da mucho control sobre cómo termina una suscripción: cuándo se aplica la cancelación, qué pasa con los créditos, si se exige un motivo y si los clientes pueden hacerlo solos. Lo que no te da por defecto es un flujo: una secuencia breve que pregunta por qué se va el cliente y le ofrece algo útil antes de que se vaya.

Esta guía muestra cómo funciona la cancelación en Chargebee Billing, qué ajustes importan y cómo construir encima un flujo de cancelación justo, ya sea con el producto de retención del propio Chargebee o con tu propia página y la API. Se ciñe a la documentación de Chargebee: Subscription Cancellation, el Self-Serve Portal, Reason Codes, la API Cancel a subscription, los tipos de eventos y el caso de uso de ofertas dirigidas de Chargebee Growth (todo consultado en noviembre de 2026).

Cómo funciona la cancelación en Chargebee

Valores por defecto del sitio

La documentación de cancelación de Chargebee sitúa los valores por defecto en Settings › Configure Chargebee › Billing LogIQ › Customers & Subscriptions › Subscription cancellation. Ahí defines:

  • Cuándo se aplica: inmediatamente, al final del plazo actual, en una fecha concreta o al final del periodo de facturación.
  • Qué pasa con el tiempo no usado: cómo se gestionan los créditos.
  • Excepciones: «Allow overriding via Chargebee interface» permite a tu equipo cambiar el valor por defecto caso por caso, y «Add condition to this rule» permite que el comportamiento varíe según el canal (interfaz web, API, Self-Serve Portal, cancelaciones programadas).

Al final del plazo: non-renewing

Cuando una cancelación se programa para el final del plazo, la suscripción no termina de inmediato. Según la API Cancel a subscription, su estado pasa a non_renewing y sus ciclos de facturación restantes bajan a 0. Después se cancela al final del plazo. Chargebee envía subscription_cancellation_scheduled cuando se programa la cancelación, un subscription_cancellation_reminder 6 días antes de que se aplique, y subscription_cancelled cuando se aplica (tipos de eventos).

Una suscripción non-renewing todavía se puede conservar. Chargebee tiene una operación «Remove scheduled cancellation» exactamente para ese caso.

Plazos contractuales

Para las suscripciones con un plazo contractual, la documentación de cancelación dice que una cancelación desde el Self-Serve Portal solo se produce al final del plazo contractual. En la API, estas suscripciones usan contract_term_cancel_option en lugar de cancel_option.

Dejar que los clientes cancelen por sí mismos

En los ajustes del Self-Serve Portal, «Allow customers to cancel subscription» activa la cancelación por autoservicio. Eliges cuándo se aplica: inmediatamente, al final del plazo, o dejar que los clientes elijan (en cuyo caso también pueden escoger una fecha dentro del periodo de la suscripción). La misma sección incluye la recogida opcional de feedback, la reactivación y la eliminación de las cancelaciones programadas.

Actívalo. Obligar a los clientes a escribir al soporte para cancelar crea una fricción que se traduce en contracargos y reseñas enfadadas, y en muchos lugares la ley espera ya que cancelar sea tan fácil como suscribirse.

Reason codes

Chargebee tiene una lista nativa de motivos de cancelación. La configuras en Settings › Configure Chargebee › Reason Codes › Subscriptions › Subscription Cancellation (Reason Codes). Los códigos aparecen después como opciones cuando se cancela una suscripción desde la interfaz de Chargebee o el Self-Serve Portal, y puedes hacerlos obligatorios.

En la API, el endpoint Cancel a subscription acepta cancel_reason_code: una cadena sensible a mayúsculas, de hasta 100 caracteres, que debe coincidir con uno de los códigos configurados, y que debe enviarse si has hecho obligatorios los motivos.

Mantén la lista corta y útil. Entre seis y ocho motivos que lleven cada uno a una respuesta distinta valen más que veinte que nadie lee:

Reason code Qué puedes ofrecer
Demasiado caro Un descuento durante unos meses, o un plan más barato
No lo uso lo suficiente Una pausa, o un plan más pequeño
Me tomo un descanso / estacional Una pausa con fecha de reanudación
Falta una funcionalidad Nada que vender; regístralo y di si está prevista
Me cambio a otra herramienta Nada; pregunta qué ha elegido y déjale ir
Problemas técnicos Una vía rápida al soporte
Otro Texto libre

Construir el flujo

Opción 1: el producto de retención del propio Chargebee

Chargebee ofrece ofertas en la página de cancelación mediante Chargebee Growth (que absorbió el producto antes llamado Chargebee Retention). Su caso de uso de ofertas dirigidas describe tres ofertas en una página de cancelación: un descuento (ligado a un cupón en Chargebee Billing), una pausa y un downgrade de plan, aplicados en Billing cuando el cliente acepta. También señala que los suscriptores sin medio de pago guardado no pueden completar el cambio ni reanudar automáticamente tras una pausa. Si ya pagas Growth, empieza por ahí.

Opción 2: tu propia página y la API

Si prefieres tu propia página, todas las piezas están en Chargebee Billing:

  1. Intercepta el botón de cancelar en tu app. Muestra tu propia página antes de cancelar nada.
  2. Pregunta el motivo. Una pregunta, con tus reason codes de Chargebee como opciones.
  3. Muestra una oferta que encaje con el motivo, o ninguna. Usa un cupón para los descuentos, la API de pausa para los descansos, o un cambio de plan.
  4. Mantén «Cancelar mi suscripción» visible en cada paso. Un clic, sin pantallas adicionales.
  5. Cancela con el motivo. Llama al endpoint de cancelación con cancel_option en end_of_term (o contract_term_cancel_option para las suscripciones con contrato) y el cancel_reason_code. Ten en cuenta que end_of_term como booleano está obsoleto en favor de cancel_option.
  6. Confirma con claridad. Muestra la fecha de fin y envía un correo de confirmación.
  7. Ofrece una vuelta atrás. Hasta la fecha de fin, un botón «Mantener mi suscripción» que elimina la cancelación programada.

Usar el motivo después de la cancelación

Chargebee señala que cancel_reason_code puede no devolverse por defecto para las suscripciones non-renewing cuando las obtienes; un ajuste a nivel de sitio lo incluye, para que puedas actuar según el motivo antes de que se ejecute la cancelación (Subscription Cancellation). Actívalo si quieres recordatorios según el motivo durante el plazo restante.

Reglas de justicia que vale la pena mantener

  • Cancelar está siempre a un clic. Una oferta es una opción, no una barrera.
  • No más de una oferta. Una segunda oferta después de un «no» parece un regateo.
  • No pidas el motivo dos veces. Si el cliente respondió en tu página, transmítelo; no le hagas elegir de nuevo en el portal.
  • Respeta la cancelación de inmediato. Si rechaza la oferta, cancela, confirma y para.

Medirlo

Sigue, por motivo: cuántos clientes llegaron a la página de cancelación, cuántos aceptaron una oferta y cuántos de ellos seguían pagando 90 días después. Una retención que cancela un mes más tarde es un retraso, no una retención. Los eventos subscription_cancellation_scheduled y subscription_cancelled de Chargebee, junto con los logs de tu propia página, te dan las tres cifras.

Hacerlo con NoChurn

La cancelación en sí sigue en Chargebee: NoChurn llama a Chargebee para cancelar, pausar o aplicar una oferta, y el portal de Chargebee sigue funcionando tal como está configurado. NoChurn aporta el flujo: motivos, una oferta por motivo (descuento, pausa o cambio de plan) y una cancelación en un clic visible en cada paso, alojado o headless mediante la API. Las respuestas alimentan un churn score de 0 a 100 y los correos de win-back a los 30, 60 y 90 días según el motivo. Consulta NoChurn + Chargebee.

PROMPT

Read https://www.nochurn.sh/llms.txt,
then follow https://docs.nochurn.sh/quickstart/
to add NoChurn to this app. Use a test key
(nc_test_…) until I say we go live.

Deja de perder ingresos.

  • Gratis hasta 300 € de MRR
  • Sin tarjeta
  • Listo en 10 minutos
  • Sin comisión