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.

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:
- 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.
- 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
-
Dirige el botón de cancelar a tu propia página, nunca directamente a la API.
-
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.
-
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 -
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.
-
Si acepta, llama a Subscription: Update y confírmalo por correo con el nuevo precio y cuánto dura.
-
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.
-
Gestiona las suscripciones vencidas. Un cliente que cancela con pagos vencidos puede deber un saldo; decide tu política y muéstrala.
-
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.