PAGOS FALLIDOSBRAINTREE

Braintree Account Updater y las tarjetas que caducan

Cómo Braintree Account Updater actualiza las tarjetas del vault, sus límites en suscripciones, los network tokens y el informe Expiring Cards.

Publicado el 6 min de lectura

Braintree Account Updater y las tarjetas que caducan

Cuando la tarjeta de un cliente caduca o se sustituye, cada suscripción en la tarjeta antigua es un pago fallido a punto de ocurrir. Braintree ofrece dos servicios que obtienen los nuevos datos de la tarjeta de las redes sin preguntar al cliente: Account Updater y los network tokens. Ninguno cubre todas las tarjetas, así que sigues necesitando una forma de llegar a los clientes que se les escapan.

Esta guía explica cómo funciona cada servicio, los detalles que importan para las suscripciones y un plan para el resto. Se ciñe a la documentación de Braintree: Account Updater, el webhook de Account Updater, el informe Expiring Cards, Network tokens overview, How network tokens work, Updating vault records y Recurring billing advanced settings (todo consultado en noviembre de 2026). Para la visión general entre proveedores, consulta network tokens y card account updaters y tarjetas que caducan.

Account Updater

Qué hace

Según la guía de Account Updater de Braintree, Account Updater solicita automáticamente actualizaciones para los medios de pago guardados en el vault cuando la tarjeta de un cliente caduca o se sustituye, para ayudar a evitar transacciones fallidas. Funciona mediante los programas de actualización de las redes de tarjetas, así que una actualización solo llega si el banco emisor participa.

Quién puede usarlo

Account Updater no está activado por defecto. Braintree dice que la mayoría de los comercios Braintree Direct domiciliados en EE. UU., o que operan principalmente con clientes estadounidenses, pueden activarlo, y pide a los demás que le contacten. Las tarifas se fijan en tu contrato: el informe de tarifas de desembolso de Braintree incluye Account Updater entre las tarifas de producto facturadas como tarifas por evento. Consulta tu contrato para conocer el precio.

Lo que no cubre

  • Las tarjetas prepago no son compatibles.
  • Las tarjetas usadas mediante Apple Pay o Google Pay no son compatibles.
  • Marcas de tarjeta: la guía para desarrolladores de Braintree menciona Visa, Mastercard y Discover, mientras que su página comercial también cita American Express. Las dos fuentes no coinciden sobre Amex; confírmalo con Braintree para tu cuenta.

Cuándo se comprueban las tarjetas

Tras un primer lote, Braintree envía solicitudes de actualización de forma continua. La guía describe varios desencadenantes, entre ellos:

  • un pago recurrente que vence en menos de dos semanas;
  • un rechazo de la tarjeta, con una excepción documentada que importa para las suscripciones: una tarjeta en una suscripción mensual que se cobró con éxito 30 días antes no se añade a un lote la primera vez que se rechaza.

Esa excepción significa que la primera renovación mensual fallida en una tarjeta sustituida puede no provocar por sí sola una actualización. Tus reintentos y tus correos a los clientes tienen que cubrirla.

Next Day Card Refresh

Braintree también describe Next Day Card Refresh, que intenta actualizar las tarjetas del vault después de que una autorización se rechace con ciertos códigos de rechazo. Solo ayuda si algo reintenta el pago después, ya sean los reintentos de la facturación recurrente de Braintree o tu propia lógica. Si tus ajustes de reintento están desactivados, la tarjeta actualizada se queda sin usar hasta el siguiente ciclo de facturación. Compruébalos en Account Settings, Recurring Billing, Options (ajustes avanzados).

Ver qué ha cambiado

Puedes revisar las actualizaciones en el Control Panel, en un informe generado o mediante el webhook Account Updater daily report. Según la referencia del webhook:

  • solo está disponible para los comercios que usan Account Updater;
  • se dispara una vez al día con los medios de pago actualizados en las últimas 24 horas, y no se dispara si no hubo ninguno;
  • el payload contiene una fecha de informe y una URL de informe, y el enlace caduca al cabo de una semana.

Descarga y guarda el informe en cuanto llegue. Si una tarjeta se actualizó, ya no necesitas escribir a ese cliente sobre ella.

Network tokens

Los network tokens son un servicio aparte de Braintree. Según el resumen de network tokens y cómo funcionan:

  • La red de tarjetas transmite a Braintree las actualizaciones del emisor (reemisión, robo, pérdida y cambios como una caducidad próxima), y Braintree actualiza los datos de la tarjeta en tu vault.
  • No hace falta ningún cambio de integración para empezar a usarlos.
  • Están disponibles para los comercios de Estados Unidos y de algunas regiones de Norteamérica, Sudamérica y Europa que procesan full stack con Braintree.
  • Un token puede no usarse siempre en una transacción determinada.

Braintree también documenta que los cargos recurrentes iniciados por el comercio llevan parámetros adicionales (como el origen de la transacción y el ID de la transacción anterior en la red) cuando gestionas los pagos recurrentes fuera de la facturación recurrente propia de Braintree. Si usas las suscripciones de Braintree, consulta con Braintree cómo se aplican los tokens a tu configuración.

Account Updater Network tokens
Cómo actualiza Solicitudes a los programas de actualización de las redes, por lotes y por desencadenantes Actualizaciones del ciclo de vida de la red al token
Configuración Hay que activarlo; elegibilidad principalmente en EE. UU. Sin cambio de integración; disponibilidad regional
Huecos Prepago, Apple Pay, Google Pay; emisores que no participan El token no siempre se usa

El informe Expiring Cards

Para las tarjetas que ninguno de los dos servicios detectará, el Control Panel de Braintree tiene un informe Expiring Cards: ve a Reports, busca la sección Vault y ejecuta Expiring Cards. Puedes filtrar por un rango de fechas personalizado o ver todas las tarjetas caducadas. Ejecútalo cada mes para el mes siguiente.

La trampa de las suscripciones: las tarjetas nuevas no mueven las suscripciones

La documentación del vault de Braintree señala que añadir un medio de pago nuevo al vault de un cliente no actualiza sus suscripciones existentes. Si un cliente añade una tarjeta nueva desde tu app, también debes actualizar cada suscripción para que use el nuevo medio de pago y después reintentar cualquier cargo vencido con Subscription: Retry Charge. Olvidar este paso es un motivo habitual por el que un cliente «actualizó su tarjeta» y aun así se perdió.

Un plan para las tarjetas que caducan en Braintree

  1. Activa Account Updater si eres elegible, y los network tokens donde estén disponibles.
  2. Activa los reintentos automáticos de la facturación recurrente para que Next Day Card Refresh tenga algo sobre lo que actuar.
  3. Guarda el informe diario de Account Updater y marca las tarjetas actualizadas en tu sistema.
  4. Ejecuta el informe Expiring Cards cada mes para las tarjetas que caducan el mes siguiente.
  5. Escribe a los clientes cuyas tarjetas no se actualizaron, 30 días antes y de nuevo unos 7 días antes de la caducidad, con un único enlace a una página de actualización de tarjeta.
  6. En la página de actualización, guarda la nueva tarjeta, pasa todas las suscripciones a ella y reintenta cualquier cargo vencido.
  7. Cubre la primera renovación mensual fallida. Como la tarjeta de una suscripción mensual no se añade a un lote en su primer rechazo, envía un correo de recuperación de inmediato en lugar de esperar al updater.
  8. Excluye las tarjetas no compatibles (prepago, Apple Pay, Google Pay) de cualquier suposición de que el updater se encargará de ellas.

Hacerlo con NoChurn

Account Updater, los network tokens y el cargo en sí siguen en Braintree. NoChurn lee de Braintree el tipo de medio de pago, la marca, los cuatro últimos dígitos y la caducidad, y añade correos escritos por IA que revisas antes de que se envíen, con una página alojada donde el cliente actualiza el medio de pago. Cuando una renovación falla de todos modos, los correos de recuperación siguen junto a los reintentos de suscripción de Braintree. 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