FLUJOS DE CANCELACIÓNBRAINTREE

Cómo añadir un flujo de cancelación a las suscripciones de Braintree

Cómo funciona la cancelación en Braintree, qué puedes cambiar en una suscripción activa (descuentos, planes, ciclos) y cómo crear un flujo de cancelación.

Publicado el 5 min de lectura

Cómo añadir un flujo de cancelación a las suscripciones de Braintree

La facturación recurrente de Braintree tiene una única operación de cancelación, y es definitiva: una suscripción cancelada no se puede editar ni reactivar. No hay página de cancelación integrada, ni encuesta de motivos, ni oferta de retención. Si quieres que los clientes vean una alternativa antes de irse, y guardar un registro de por qué se fueron, construyes ese flujo en tu app y llamas a Braintree al final.

Esta guía cubre las operaciones de Braintree en las que se apoya un flujo de cancelación, los límites que le dan forma y un diseño paso a paso. Se ciñe a la documentación de Braintree: Subscription: Cancel, Subscription: Update, Manage subscriptions, Plans, Statuses, Subscription webhooks y la guía de suscripciones (todo consultado en noviembre de 2026).

Cómo funciona la cancelación en Braintree

Subscription: Cancel pasa una suscripción a Canceled, que la referencia de estados de Braintree describe como sin más facturación. La referencia es explícita: una vez cancelada una suscripción, no puedes editarla ni reactivarla; un cliente que vuelve necesita una suscripción nueva.

Tres consecuencias para tu flujo:

  • Cancelar es el último paso, nunca el primero. Presenta todas las ofertas antes de la llamada.
  • No hay opción de «cancelar al final del periodo» en la operación de cancelación. Si cancelas a mitad de ciclo, la facturación se detiene, y lo que el cliente conserve como acceso lo decides tú en tu app.
  • Guarda tú mismo la fecha de cancelación. Braintree señala que la fecha de cancelación no se incluye en los resultados de búsqueda de suscripciones y sugiere capturarla desde el webhook subscription_canceled.

Terminar al final del periodo pagado

Muchos negocios quieren que el cliente conserve el acceso hasta el final de lo que pagó, sin más cargos. Dos enfoques encajan con el modelo de Braintree:

  1. Cancelar ahora y mantener el acceso en tu app hasta el final del periodo de facturación actual, usando la fecha de fin de periodo que guardaste para la suscripción.
  2. Limitar el número de ciclos de facturación. Subscription: Update te permite fijar el número de ciclos de facturación, que debe ser mayor o igual que el ciclo actual, y desactiva «never expires». Cuando una suscripción llega a su número de ciclos fijado, Braintree la marca como Expired. Así la suscripción termina de forma natural tras el ciclo actual, y un cliente que cambia de opinión antes puede recuperarse volviendo a ponerla en never expire.

El segundo enfoque mantiene la suscripción editable hasta que termina, lo que facilita «deshacer». Pruébalo en el sandbox con los ajustes de tu plan antes de confiar en él.

Qué puedes ofrecer en su lugar

La operación de actualización de Braintree te da las palancas para las ofertas de retención.

Descuentos

Puedes añadir, actualizar o quitar descuentos (y add-ons) en una suscripción existente. Reglas clave de la documentación:

  • Los detalles del descuento (nombre, importe, duración) se gestionan en el Control Panel, no mediante la API. Crea primero ahí tus descuentos de retención y después aplícalos por ID.
  • Un descuento determinado solo se puede aplicar una vez a una suscripción; para aplicarlo más de una vez, usa su cantidad.

Crea un descuento de retención específico, por ejemplo «Retention 30% x3», para que las ofertas aceptadas sean fáciles de encontrar en los informes y nunca se confundan con descuentos comerciales.

Cambios de precio y de plan

Puedes cambiar el precio de la suscripción, con una opción que controla si el cambio se prorratea, o pasarla a otro plan. Braintree señala que cambiar a un plan con una frecuencia de facturación distinta solo está disponible para algunos comercios que lo soliciten, y reinicia el ciclo de facturación actual. Para la mayoría de los flujos de cancelación, un downgrade a un plan más barato con la misma frecuencia es la oferta más sencilla.

Una pausa

La documentación de Braintree que hemos revisado no describe ninguna operación de pausa ni de «saltar un ciclo» para las suscripciones. El webhook subscription_billing_skipped existe, pero se dispara cuando se salta un ciclo porque un saldo cero o negativo ya lo cubre, no a petición. Si quieres ofrecer una pausa, tendrías que construirla sobre Braintree (por ejemplo con un descuento total temporal durante un número fijo de ciclos) y probar antes con cuidado el comportamiento de la facturación.

Los webhooks que debe escuchar tu flujo

Según los webhooks de suscripción de Braintree:

Tipo Uso en un flujo de cancelación
subscription_canceled Registrar la fecha de cancelación, retirar el acceso cuando toque, empezar el win-back
subscription_expired La suscripción llegó a su último ciclo (para el enfoque de «ciclos limitados»)
subscription_charged_successfully Confirma que se cobró el precio de una oferta

Escúchalos incluso para las cancelaciones que provocas tú mismo. Los agentes de soporte pueden cancelar desde el Control Panel, y esas cancelaciones deben acabar en los mismos registros.

Construir el flujo

  1. Dirige el botón de cancelar a tu propia página, nunca directamente a la API.

  2. Pregunta por qué. De cinco a siete motivos más «Otro». Guarda la respuesta con el ID de suscripción de Braintree. Ideas en encuestas de motivos de cancelación.

  3. Muestra una oferta que corresponda al motivo:

    Motivo Oferta Operación de Braintree
    Demasiado caro Descuento por tiempo limitado Update: añadir un descuento de retención
    Necesito menos Plan más barato Update: cambiar de plan o de precio
    No lo uso ahora mismo Una pausa, si has construido una Tu propia lógica (ver arriba)
    Problema técnico Ayuda del soporte Ninguna hasta que se resuelva
    Me cambio o cierro Ninguna oferta Cancel
  4. Mantén «Cancelar suscripción» visible en cada paso, igual de fácil de pulsar que la oferta. Normas y buenas prácticas en normas de click to cancel y buenas prácticas del flujo de cancelación.

  5. Si acepta, llama a Subscription: Update y confírmalo por correo con el nuevo precio y cuánto dura.

  6. Si cancela, llama a Subscription: Cancel (o limita los ciclos de facturación), muestra la fecha en que termina el acceso y envía una confirmación.

  7. Gestiona las suscripciones vencidas. Un cliente que cancela con pagos vencidos puede deber un saldo; decide tu política y muéstrala.

  8. Revisa cada mes qué motivos aparecen más y qué ofertas siguen pagando a los tres meses.

Errores habituales

  • Cancelar y después intentar aplicar una oferta. Las suscripciones canceladas no se pueden editar.
  • Crear los descuentos en el código. Los detalles de los descuentos viven en el Control Panel; planifícalos con antelación.
  • Perder la fecha de cancelación. Sin el webhook guardado, no puedes programar los correos de win-back ni medir el churn por mes.
  • Esconder la opción de cancelar detrás de la oferta. Cuesta confianza y, en muchos lugares, incumple las normas.

Hacerlo con NoChurn

Braintree se queda con la suscripción, los pagos y la cancelación en sí. El flujo de cancelación de NoChurn pregunta el motivo, muestra una oferta (un descuento, un cambio de plan o una cancelación en la suscripción de Braintree) y mantiene una cancelación en un clic visible en cada paso, alojado o headless mediante la API. Las respuestas alimentan los correos de win-back a los 30, 60 y 90 días y un churn score de 0 a 100, y se convierten en pruebas si el cliente disputa más tarde un cargo. Consulta NoChurn + Braintree.

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