PAGOS FALLIDOSBRAINTREE

Cómo recuperar pagos de suscripción fallidos en Braintree

Cómo gestiona Braintree los cargos de suscripción fallidos: estado Past Due, reintentos automáticos, Account Updater, webhooks y disputas.

Publicado el 7 min de lectura

Cómo recuperar pagos de suscripción fallidos en Braintree

La facturación recurrente de Braintree es deliberadamente austera. Cobra las suscripciones, reintenta los cargos fallidos según un calendario que tú eliges y te cuenta lo que ha pasado mediante webhooks. Todo lo demás, incluidos los correos a los clientes, una página para actualizar la tarjeta y lo que hace tu producto mientras una suscripción tiene pagos vencidos, depende de ti. Esta guía cubre lo que Braintree hace de forma nativa, los ajustes que importan y las piezas que tienes que añadir. Termina con una sección breve sobre las disputas, ya que una renovación fallida o impugnada a menudo se convierte en una.

Se ciñe a la documentación de Braintree: Recurring billing advanced settings, el resumen de la facturación recurrente, Statuses, Subscription: Retry Charge, Subscription webhooks, Account Updater y Managing disputes via the API (todo consultado en noviembre de 2026).

Qué pasa cuando falla el cargo de una suscripción

Cuando Braintree factura una suscripción y la transacción es rechazada por el procesador o por la pasarela, la suscripción pasa a Past Due. A partir de ahí, según la guía de ajustes avanzados:

  • Braintree reintenta automáticamente si los reintentos están activados en el Control Panel.
  • Un reintento con éxito devuelve la suscripción a Active, siempre que no haya pasado su fecha final de facturación.
  • Los reintentos automáticos no cambian las fechas de inicio y fin del periodo de facturación actual.
  • Algunos códigos de rechazo, como una tarjeta caducada o robada, nunca se reintentan porque indican que es poco probable que la transacción llegue a tener éxito.

El objeto subscription te ayuda a seguirlo: daysPastDue da el número de días que la suscripción lleva vencida y failureCount cuenta los intentos de cargo fallidos consecutivos.

Los estados de suscripción de un vistazo

Estado Significado (según la referencia de estados de Braintree)
Active Factura con normalidad
Past Due Un cargo falló; puede haber reintentos pendientes
Canceled No habrá más facturación
Expired La suscripción llegó a su número fijado de ciclos de facturación

Expired no es un estado de fallo; una suscripción que termina por impago aparece como Canceled o sigue en Past Due, según tus ajustes.

Los ajustes de reintento

Los reintentos se configuran en el Control Panel, en Account Settings, Recurring Billing, Options, no mediante la API. Los ajustes que documenta Braintree:

  • Si se reintentan automáticamente las transacciones fallidas.
  • Días antes del primer reintento, entre 1 y 10 días.
  • Qué hacer cuando fallan los reintentos: cancelar la suscripción, seguir reintentando o dejarla vencida.

El último ajuste merece una elección deliberada:

Opción Qué hace Braintree Cuándo tiene sentido
Cancelar Termina la suscripción Quieres un estado final claro y recuperarás a los clientes por separado
Seguir reintentando Reintenta una vez por ciclo de facturación, en la fecha de facturación habitual Planes de poco valor en los que los clientes suelen recargar más tarde
Dejar vencida El saldo sigue acumulándose cada ciclo, sin más reintentos Cobrarás tú mismo y necesitas el historial

Con «dejar vencida», el saldo crece cada ciclo sin ningún intento nuevo, así que alguien tiene que contactar con el cliente. Con «seguir reintentando», solo hay un intento por ciclo, así que no sustituye a unos reintentos rápidos tras el primer fallo.

Reintentos manuales

Puedes reintentar tú mismo una suscripción vencida con Subscription: Retry Charge, desde la API o el Control Panel. Pasa true para enviar automáticamente la transacción a liquidación si el reintento tiene éxito. Un reintento manual con éxito devuelve la suscripción a Active; un reintento manual fallido no cuenta como uno de los intentos automáticos. Es lo que llamas justo después de que un cliente actualice su tarjeta, en lugar de esperar al siguiente reintento programado.

Account Updater

Account Updater solicita datos actualizados para las tarjetas del vault que han caducado o se han sustituido, lo que evita algunos fallos antes de que ocurran. Según la documentación de Braintree:

  • Las actualizaciones dependen de que el banco emisor participe; las tarjetas prepago y las usadas mediante Apple Pay o Google Pay no son compatibles.
  • Tras el primer lote, las solicitudes se envían de forma continua, incluido cuando un pago recurrente vence en menos de dos semanas, y después de algunos rechazos.
  • Puedes revisar las actualizaciones en el Control Panel, en un informe o mediante un webhook diario.

Un detalle importante: añadir un medio de pago nuevo al vault de un cliente no traslada a él las suscripciones existentes. Si un cliente te da una tarjeta nueva, actualiza el token del medio de pago de la suscripción y después reintenta el cargo.

Webhooks de suscripción

Braintree envía estos tipos de webhook de suscripción:

Tipo Cuándo se dispara Qué hacer
subscription_charged_unsuccessfully Una suscripción existente no consigue un cargo con éxito (no en reintentos manuales, no en el cargo inicial) Registrar el rechazo, empezar los mensajes al cliente
subscription_went_past_due La suscripción pasa de Active a Past Due (una vez por ciclo) Mostrar un banner en la app, enviar el primer correo
subscription_charged_successfully Un cargo tiene éxito Detener los mensajes, quitar el banner
subscription_went_active La suscripción pasa a Active Restablecer el acceso
subscription_canceled La suscripción se cancela Retirar el acceso, guardar la fecha de cancelación
subscription_expired La suscripción llegó a su último ciclo Terminar el acceso según lo previsto

Braintree señala que la fecha de cancelación no se devuelve en los resultados de búsqueda de suscripciones, así que si la necesitas, guárdala cuando llegue subscription_canceled.

Lo que tienes que añadir tú

Braintree documenta algunas notificaciones por correo para la facturación recurrente; comprueba lo que cubren para tu cuenta. Un proceso de recuperación completo suele necesitar más:

  1. Un primer correo con subscription_went_past_due, enviado el mismo día, con un único enlace para actualizar la tarjeta. No cites el motivo de rechazo en bruto.
  2. Una página de actualización de tarjeta construida con la integración del lado del cliente de Braintree, para que los datos de la tarjeta vayan directamente a Braintree y nunca toquen tus servidores. Si tiene éxito, actualiza el medio de pago de la suscripción y llama a Retry Charge.
  3. Recordatorios sincronizados con los reintentos, por ejemplo un día después de que falle cada reintento programado.
  4. Un último aviso antes de que se cancele la suscripción, con la fecha.
  5. Un banner en la app mientras la suscripción está vencida.
  6. Un tratamiento aparte para los rechazos duros. Si la tarjeta está caducada o se ha denunciado como robada, Braintree no reintentará, así que el correo es la única vía de recuperación: envíalo de inmediato.

Disputas de Braintree

Las disputas son la otra vía por la que se escapan los ingresos de suscripción, y Braintree ofrece una API completa para ellas, descrita en Managing disputes via the API:

  • Los webhooks de tipo dispute_opened, dispute_won, dispute_lost, dispute_accepted, dispute_expired y otros te avisan cuando se abre un caso o cambia de estado.
  • Las pruebas de texto (por ejemplo un reembolso o un número de seguimiento) se añaden con Dispute: Add Text Evidence.
  • Las pruebas en archivo se suben con una solicitud Document Upload y después se adjuntan con Dispute: Add File Evidence. La documentación de Braintree da un límite de 4 MB por archivo y de 5 MB por disputa por defecto.
  • Finalize envía tu respuesta y tus pruebas al banco del titular. Las pruebas solo se pueden añadir mientras la disputa está abierta.
  • Fecha límite de respuesta: cada disputa tiene una. Si se te pasa, pierdes el derecho a impugnar y la disputa pasa a expired.
  • Aceptar una disputa significa que no la impugnas y que los fondos vuelven al cliente.

Para un negocio de suscripción, la prueba más sólida suele ser el historial: cuándo se registró el cliente, qué usó, qué avisos recibió y si alguna vez intentó cancelar. Reúnelo antes de que se acerque la fecha límite.

Hacerlo con NoChurn

Braintree se queda con el procesamiento de las tarjetas, tu cuenta de comercio y sus propios reintentos de suscripción; NoChurn trabaja junto a ellos. Se conecta con tu merchant ID y tus claves de API de Braintree, sigue los webhooks de Braintree y añade correos de recuperación escritos por IA que revisas antes de que se envíen, con una página alojada para actualizar el medio de pago. Para las disputas, NoChurn reúne pruebas automáticamente (respuestas del flujo de cancelación, correos enviados, uso, conversaciones de soporte) y redacta una respuesta con IA, que solo se envía a Braintree después de que la revises. También añade flujos de cancelación con ofertas y una cancelación en un clic siempre visible, correos de win-back a los 30, 60 y 90 días y un churn score de 0 a 100. 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