PAGOS FALLIDOSMAXIO

Cómo gestionar las tarjetas que caducan en Maxio

Qué hace Maxio con las tarjetas que caducan: correos de aviso, el webhook expiring_card, el account updater según la pasarela y cómo pedir una tarjeta nueva.

Publicado el 6 min de lectura

Cómo gestionar las tarjetas que caducan en Maxio

Una tarjeta que caduca es el pago fallido más previsible que existe: sabes en qué mes dejará de funcionar antes de que ocurra. Maxio Advanced Billing (antes Chargify) te da tres herramientas para ello: correos automáticos de caducidad de tarjeta, un webhook expiring_card y compatibilidad con el account updater en algunas pasarelas. Esta guía explica qué hace cada una, qué huecos deja y cómo combinarlas para que las renovaciones no fallen por un motivo que podías ver venir.

Se limita a la documentación de Maxio: configurar los ajustes de correo, plantillas de correo, eventos de webhook, ejemplos de payload, comparar las funciones de las pasarelas, gestionar métodos de pago, actualizar la información de pago de un cliente y el glosario de Advanced Billing (todos consultados en noviembre de 2026). Cuando las páginas de Maxio no coinciden, lo indicamos. Para lo que pasa cuando una renovación ya ha fallado, consulta cómo reducir el churn involuntario en Maxio.

Paso 1: deja que el account updater haga lo que pueda

Las redes de tarjetas tienen servicios de account updater: cuando un banco reemite una tarjeta, el número nuevo o la nueva fecha de caducidad pueden llegar al comercio sin que el cliente haga nada. En Maxio, la compatibilidad depende de tu pasarela:

Pasarela Account updater en Advanced Billing
Stripe, BlueSnap, Cybersource, Forte (Beta), Maxio Payments Totalmente compatible: Maxio recibe las actualizaciones y mantiene al día los datos de tarjeta guardados
Otras pasarelas El updater de la pasarela suele seguir funcionando mediante su token, así que los cobros pueden funcionar, pero los datos de la tarjeta nueva pueden no aparecer en Advanced Billing

Algunas pasarelas necesitan configuración. Para BlueSnap, la guía de configuración de Maxio te pide configurar los webhooks de BlueSnap y marcar “Send Account Updater”. Para Forte, el updater debe activarse antes en la cuenta de Forte. En Stripe, la documentación de Maxio vincula el updater automático a la integración con Stripe Connect.

Dos límites según la documentación de Maxio:

  • No todos los bancos emisores participan. Un updater solo funciona cuando el banco emisor de la tarjeta participa, así que algunas tarjetas caducarán sin actualización.
  • Un updater puede desactivar un perfil. Cuando un updater no encuentra una cuenta, puede eliminar el registro y dejar desactivado el perfil de pago del suscriptor. La página de métodos de pago de Maxio dice que, en el momento de escribirla, esto solo les había pasado a comercios de Authorize.Net que usaban el updater.

El segundo punto importa para el primero: si tu pasarela actualiza la tarjeta sin avisar y Maxio no lo muestra, Maxio puede seguir creyendo que la tarjeta está a punto de caducar y escribir al cliente por ello. Sabe en qué caso estás antes de escribir el correo.

Paso 2: los correos de caducidad de tarjeta

Maxio puede enviar Card Expiration Emails a los clientes cuya tarjeta guardada está a punto de caducar (plantillas de correo). La plantilla puede incluir el número de días hasta la caducidad y un enlace de actualización, {{update_url}}, que es la URL de autoservicio de la suscripción, para que el cliente introduzca él mismo la tarjeta nueva y tú nunca manejes datos de tarjeta.

Cuándo se envían: dos versiones en la documentación de Maxio

Las páginas de Maxio dan dos calendarios:

  • La página actual de ajustes de correo dice que los correos salen tres veces durante el mes en que caduca la tarjeta: el día 1, el día 15 y una semana antes de fin de mes (así que la tercera fecha cambia según la duración del mes).
  • El glosario y la página de plantillas de correo mencionan los días 1, 15 y 23, y el glosario se refiere al mes anterior a la caducidad de la tarjeta.

La página de ajustes de correo es la más concreta y parece la más reciente, pero comprueba un envío real en tu sitio antes de construir algo que dependa de las fechas exactas.

Haz que el correo sea útil

La plantilla por defecto es un punto de partida. Un buen correo de tarjeta a punto de caducar:

  1. Dice qué tarjeta (marca y cuatro últimos dígitos) y qué suscripción.
  2. Da la fecha en que se cobrará la próxima renovación, si cae después de la caducidad.
  3. Tiene un único botón hacia el enlace de actualización, que funciona en el móvil, sin contraseña que recordar.
  4. Viene de tu marca y de una dirección real a la que se puede responder.

Paso 3: el webhook expiring_card

Maxio también envía un webhook expiring_card. Según su página de eventos de webhook, es periódico: se envía el día 1, el día 15 y 7 días antes de fin de mes, e identifica todas las tarjetas que caducan en el mes en curso. El payload lleva el objeto subscription, con el cliente, el producto y los datos de la tarjeta.

Fíjate en lo que eso implica: el webhook llega en el mes de la caducidad, no semanas antes. Para un plan mensual facturado a principios de mes, está bien. Para un cliente cuya renovación es el día 2 y cuya tarjeta caduca a finales de ese mes, también. Pero para un plan anual que se renueva la próxima primavera, una alerta de “caduca este mes” hoy no es el problema; lo es la tarjeta que estará guardada en la renovación. Usa el webhook como disparador y decide qué hacer con tu propia lógica:

  • Renovación antes de la caducidad: no hace falta hacer nada ahora; la próxima renovación funcionará.
  • Renovación después de la caducidad, plan mensual: pide una tarjeta nueva ahora.
  • Plan anual: compara tú mismo, con antelación, la fecha de caducidad de la tarjeta con la fecha de renovación, en lugar de esperar al webhook.

Paso 4: otras formas de conseguir una tarjeta nueva

Cuando el correo no funciona, Maxio ofrece opciones manuales y masivas (actualizar la información de pago de un cliente):

  • Desde la suscripción. En la pestaña Payment Details, “Email Customer to Request Payment Update” envía al cliente un enlace a su página de autoservicio. Maxio lo recomienda antes que introducir tú los datos de la tarjeta nueva del cliente.
  • En bloque. Un correo masivo predefinido “Request Payment Method Update” envía un enlace de actualización seguro a un grupo de suscriptores.
  • En el Billing Portal. Los clientes añaden una tarjeta en Payment, o usan Update Payment Method en una suscripción concreta.
  • Maxio Core. Si usas Maxio Core en lugar de Advanced Billing, la documentación describe cómo copiar un enlace de la página del perfil de facturación e-Bill del cliente y enviarlo.

Añade también un mensaje dentro de tu propio producto: un banner para el titular de la cuenta cuando su tarjeta caduca este mes llega a las personas que ignoran el correo.

Una lista de control

  • Sabes si el account updater de tu pasarela es totalmente compatible con Advanced Billing.
  • Los ajustes del updater en la pasarela están activados donde hace falta.
  • Los Card Expiration Emails están activados, con tu marca y un enlace de actualización que funciona.
  • Has comprobado con un envío real qué calendario usa Maxio en tu sitio.
  • expiring_card está gestionado, con una lógica distinta para planes mensuales y anuales.
  • En los planes anuales se compara la caducidad con la fecha de renovación con mucha antelación.
  • Un banner en la app aparece cuando la tarjeta guardada está a punto de caducar.
  • El dunning está configurado para las tarjetas que no pudiste captar a tiempo.

Hacerlo con NoChurn

NoChurn lee las suscripciones de Maxio y el tipo y la fecha de caducidad de cada perfil de pago, y los usa en el churn score de 0 a 100 del cliente. Cuando una renovación falla de verdad, NoChurn envía correos de recuperación escritos por IA y revisados por ti, junto a tu dunning de Maxio, con un enlace para actualizar el perfil de pago. Los datos de la tarjeta, el cobro y el account updater siguen en Maxio y en tu pasarela. NoChurn es gratis por debajo de 300 € de MRR, con todas las funciones en todos los planes (tu propio dominio para correos y páginas alojadas como complemento de 14,99 € al mes en cualquier plan). 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