FLUJOS DE CANCELACIÓNMAXIO

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

Cómo funciona la cancelación en Maxio Advanced Billing: inmediata o diferida, códigos de motivo, ajustes del Billing Portal, holds, cupones y cambios de plan.

Publicado el 6 min de lectura

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

Un flujo de cancelación se sitúa entre el botón “Cancelar” y la cancelación: pregunta por qué, hace una oferta que encaja con el motivo y cancela limpiamente si el cliente sigue queriendo irse. Maxio Advanced Billing (antes Chargify) ya tiene varias de las piezas: cancelación diferida, códigos de motivo de churn, holds y cambios de producto programados. Esta guía explica cómo funcionan y cómo combinarlos en un flujo.

Se limita a la documentación de Maxio: cancelar suscripciones, programar la cancelación de una suscripción, gestionar suscripciones en el Billing Portal, configurar las funciones del Billing Portal, códigos de motivo de churn, escenarios de hold y reanudación, aplicar cupones a suscripciones, las referencias de la API update subscription e initiate delayed cancellation, y los ejemplos de payload de webhooks (todos consultados en noviembre de 2026). Algunos ejemplos de la API de Maxio todavía usan URL antiguas de Chargify; comprueba los endpoints de tu sitio.

Cómo funciona la cancelación en Maxio

Maxio ofrece tres momentos (cancelar suscripciones):

Momento Qué pasa
Inmediatamente La suscripción se cancela ahora
Al final del periodo Sigue funcionando durante el periodo pagado en un estado Pending Cancellation y después se cancela
En una fecha programada Se cancela en una fecha futura que eliges tú o el cliente (requiere la función de programación)

En todos los casos, Maxio no reembolsa ni prorratea automáticamente. Para un cliente que decidió irse, el final del periodo es la opción justa por defecto: conserva lo que pagó.

Una cancelación pendiente puede quitarse: la guía de Maxio para crear tu propio Billing Portal indica un endpoint aparte para eso. Mediante la API, una cancelación diferida acepta un código de motivo y el indicador cancel_at_end_of_period; programar una fecha requiere que la función Schedule Subscription Cancellation esté activada en tu sitio.

Algunas suscripciones no pueden programarse para cancelarse. Según Maxio, las suscripciones prepago siempre se cancelan inmediatamente, y las suscripciones en estados como Past Due, Expired o Paused no pueden programarse (programar una cancelación). Tu flujo tiene que gestionar esos casos.

Códigos de motivo de churn

Maxio tiene códigos de motivo de churn integrados. Los creas, editas, ordenas y borras en los ajustes de tu sitio, y aparecen cuando alguien cancela desde el resumen de la suscripción. Una vez que tu sitio tiene códigos configurados, hay que elegir un motivo antes de confirmar una cancelación. Cuando se usan códigos, los análisis de churn de Maxio muestran el motivo de cada evento de churn. Úsalos aunque crees tu propio flujo: envía el código de motivo con la cancelación, para que los informes de Maxio y los tuyos coincidan.

El Billing Portal

El Billing Portal alojado de Maxio permite a los clientes cancelar desde Plan Details, eligiendo entre la cancelación inmediata y la de final de periodo (suscripciones en el Billing Portal). Lo controlas con interruptores separados en las funciones del Billing Portal:

  • Allow Immediate Cancellations
  • Allow Delayed Cancellations (at end of period)
  • Allow Scheduling Cancellations, para que los clientes elijan una fecha futura
  • Display Churn Reason Codes, para que los clientes elijan un motivo al cancelar

El portal pide confirmación, y Maxio indica que después de ese paso no se puede deshacer. Lo que el portal no hace es una oferta: registra un motivo y cancela. Si quieres un paso de retención, ponlo en tu app antes de que el cliente llegue al portal, o desactiva la cancelación en el portal y gestiónala tú. Si mantienes la cancelación en el portal, activar solo la cancelación diferida es una opción sensata.

Las ofertas que admite Maxio

Hold (pausa)

Maxio llama hold a una pausa (escenarios de hold y reanudación). Mientras está en hold, no hay renovaciones. Un hold puede llevar una fecha de reanudación, y la suscripción se reanuda sola (el objeto subscription tiene un campo automatically_resume_at). Solo una suscripción Active puede ponerse en hold. Un detalle importa para los flujos de cancelación: una suscripción que debía cancelarse al final del periodo no se cancela mientras está en hold; se cancela después de reanudarse.

La guía de Maxio enumera endpoints de hold y de reanudación, pero sus propias páginas los muestran con dos formas de ruta (con y sin /subscriptions/:id), así que revisa la referencia actual de la API antes de construir sobre ellos.

Cupón

Los cupones de Maxio pueden añadirse a una suscripción existente (aplicar cupones). Dos reglas de la documentación:

  • La duración del cupón se cuenta desde la siguiente renovación de la suscripción, no desde el registro.
  • Un cupón solo se aplica a planes de la misma familia de productos.

Las páginas que encontramos describen cómo añadir un cupón en la interfaz de administración; revisa la referencia de la API de Maxio para la llamada que usarás desde tu app.

Cambio de producto

Para “demasiado caro”, un plan más barato suele ser mejor que un descuento. Maxio admite un cambio de producto diferido (update subscription): fija product_handle en el nuevo producto y product_change_delayed en true, y el cambio se hace en la siguiente renovación sin prorrateo. Enviar un producto siguiente vacío anula un cambio programado. Los cupones de la suscripción solo se mantienen si están restringidos al nuevo plan o no tienen restricción.

Construir el flujo

  1. Envía el “Cancelar” de tu app a tu flujo. Decide qué permite el Billing Portal, para que los clientes no lleguen a dos experiencias de cancelación distintas.
  2. Comprueba qué es posible para esta suscripción. Las suscripciones prepago se cancelan inmediatamente; las Past Due y Paused no pueden programarse. Un hold necesita una suscripción Active.
  3. Pregunta por qué, con la misma lista que tus códigos de motivo de churn de Maxio.
  4. Muestra una oferta que encaje. “Demasiado caro”: un cambio de producto diferido o un cupón. “No lo uso ahora mismo”: un hold con fecha de reanudación. “Falta una función”: una respuesta de una persona.
  5. Mantén “Cancelar ahora” visible en cada paso. Un clic termina la cancelación, sin aceptar ninguna oferta.
  6. Aplica el resultado. Cancelación diferida con el código de motivo y cancel_at_end_of_period; o el hold, el cupón o el cambio de producto.
  7. Confirma la fecha a partir de la suscripción que devuelve Maxio, y ofrece deshacer una cancelación pendiente hasta que se haga efectiva.

Webhooks que escuchar

De los ejemplos de payload y los eventos de webhook de Maxio:

  • subscription_state_change lleva state y previous_state: úsalo para ver una suscripción pasar a cancelada, en hold o de nuevo a activa.
  • pending_cancellation_change tiene un payload de ejemplo con cancel_at_end_of_period y delayed_cancel_at. Las páginas de Maxio que encontramos no dicen exactamente cuándo se dispara, así que pruébalo en tu sitio.

Maxio dice que los webhooks son asíncronos y aconseja comprobar que previous_state coincide con lo que tienes antes de actualizar tus registros, y obtener la suscripción de la API en caso de duda.

Hacerlo con NoChurn

NoChurn se conecta a Maxio con una clave de API, importa clientes y suscripciones y sigue los webhooks de Maxio. Añade un flujo de cancelación con motivos, ofertas que se convierten en un cupón o un cambio de producto en la suscripción de Maxio, y una cancelación en un clic siempre visible, alojado o headless mediante la API. También envía correos de win-back los días 30, 60 y 90 según el motivo de cancelación y calcula un churn score de 0 a 100. La facturación, los impuestos, tus productos y el cobro siguen en Maxio y en tu pasarela. NoChurn es gratis por debajo de 300 € de MRR. Consulta NoChurn + Maxio.

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