PAGOS FALLIDOSCHARGEBEE

Cómo recuperar los pagos fallidos en Chargebee

El dunning de Chargebee: modos Smart y Custom, periodo de dunning, acciones finales, correos, enlace de actualización de tarjeta y eventos payment_failed.

Publicado el 6 min de lectura

Cómo recuperar los pagos fallidos en Chargebee

Chargebee tiene un sistema de dunning maduro: clasifica los errores de pago, reintenta según su propio calendario o el tuyo, escribe a los clientes con un enlace para actualizar su tarjeta y aplica una acción final cuando nada funciona. La mayor parte de la recuperación que puedes obtener de Chargebee se reduce a un puñado de ajustes y a lo bien escritos que estén tus correos. Esta guía explica esos ajustes y lo que conviene añadir a su alrededor.

Se ciñe a la documentación de Chargebee: Dunning, Smart and manual dunning, What is Smart Dunning, qué webhook se dispara durante el dunning, la API Invoices, el evento payment_failed, el Self-Serve Portal y cómo actualizan los clientes su medio de pago (todo consultado en noviembre de 2026). Chargebee tiene dos generaciones de dunning; esta guía describe la actual y señala dónde difiere la versión anterior.

Cómo funciona el dunning de Chargebee

Cuando falla un cargo de renovación automática, la factura entra en dunning. Chargebee reintenta entonces el pago y envía correos de recordatorio durante un periodo de dunning: el número de días que la factura permanece en dunning antes de que se ejecute la acción final. Los reintentos solo ocurren dentro de esa ventana.

Con el cobro automático activado, la suscripción permanece Active durante el dunning. Lo que pasa después depende de tus ajustes.

Dos modos de reintento

La página de Dunning de Chargebee describe dos modos:

Modo Smart Modo Custom
Quién elige el momento Chargebee, según el error de la pasarela Tú, en días tras el primer fallo
Reintentos máximos Hasta 12 Hasta 5
Rechazos duros No se reintentan hasta que cambia el medio de pago La documentación describe reintentos en los días que fijes
Fechas exactas No garantizadas Fijas

El modo Smart clasifica los códigos de error de la pasarela como rechazos duros o blandos. Los rechazos duros esperan a que el cliente actualice su medio de pago. Para los rechazos blandos, Chargebee elige un momento para reintentar según la categoría del error y las probabilidades de recuperación. La documentación de Chargebee dice que en este modo no se pueden garantizar las fechas exactas de reintento. Un «Collect Now» manual también cuenta como reintento. Un artículo de ayuda de Chargebee indica que Smart Dunning está disponible a partir de determinados planes, así que comprueba el tuyo.

El modo Custom te permite fijar los días de reintento. El ejemplo de Chargebee: con un periodo de dunning de 8 días y una frecuencia de reintento de «1,4,8», los reintentos se ejecutan 1, 4 y 8 días después del primer fallo.

Chargebee también comercializa Revive, un modo de reintento con machine learning que funciona dentro de los límites de Smart Dunning. Consulta con Chargebee su disponibilidad en tu plan.

Fallos de 3D Secure

Elijas el modo que elijas, Chargebee dice que los pagos que fallaron por 3D Secure solo se reintentan el día anterior al final del periodo de dunning, si el cliente no ha actuado. Esos clientes tienen que completar la autenticación ellos mismos, así que lo que los recupera es el correo, no el reintento.

La acción final

Cuando fallan todos los reintentos, eliges qué pasa con:

  • la suscripción: cancelarla o mantenerla activa;
  • la factura: marcarla como no pagada, darla por incobrable o anularla.

Cancelar es la opción estricta; mantener la suscripción activa con la factura sin pagar te da más tiempo para contactar con el cliente, a costa de dar servicio a alguien que no ha pagado. Elige a propósito en lugar de dejar el valor por defecto.

Dunning v1

Los sitios más antiguos pueden seguir en Dunning v1. Los propios artículos de ayuda de Chargebee dan números de reintentos distintos para la v1, así que si tu sitio la usa, comprueba los ajustes en tu panel en lugar de fiarte de un artículo, y considera pasar a la versión actual.

Los correos de dunning y el enlace de actualización de tarjeta

Chargebee envía correos de dunning durante los intentos de reintento, y esos correos incluyen un enlace donde el cliente puede actualizar su medio de pago en las páginas alojadas de Chargebee (guía de actualización del medio de pago). Chargebee también puede avisar a los clientes cuando una tarjeta está a punto de caducar, ha caducado o deja de ser válida.

Hay otras tres formas de conseguir un nuevo medio de pago:

  1. Request payment method. Desde la página de un cliente o de una suscripción en el panel, el equipo puede enviar un enlace seguro a la página alojada de Chargebee.
  2. Self-Serve Portal. Una vez activado en Settings › Configure Chargebee › Checkout and Self-Serve Portal, los clientes pueden gestionar sus medios de pago y pagar las facturas pendientes (Self-Serve Portal).
  3. API. La API de páginas alojadas para gestionar las fuentes de pago devuelve una URL a la que rediriges al cliente, si quieres el enlace dentro de tu propia app o de tus correos.

Las plantillas de correo por defecto son un punto de partida. Edítalas para que el cliente reconozca tu marca, entienda lo que ha fallado y vea un único botón claro.

Eventos y webhooks

La recomendación de Chargebee para seguir el dunning es escuchar payment_failed y leer el dunning_status de la factura:

dunning_status Significado
in_progress La factura está en dunning, quedan reintentos
exhausted El último reintento falló; el periodo de dunning ha terminado
success Se cobró un pago durante el dunning
stopped El dunning se detuvo para esta factura

Cada intento fallido durante el dunning genera un evento payment_failed; solo el último lleva exhausted (qué evento marca el final del dunning). payment_succeeded se dispara cuando se cobra un pago. Úsalos para mantener sincronizados tus propios registros, para detener cualquier comunicación adicional en el momento en que un pago tiene éxito y para saber cuándo se ha ejecutado la acción final.

Una configuración de recuperación, paso a paso

  1. Elige un modo de reintento. El modo Smart es la opción sensata por defecto para los pagos con tarjeta si tu plan lo incluye, ya que evita reintentos inútiles en los rechazos duros. Usa el modo Custom si necesitas fechas previsibles, por ejemplo para coincidir con el día en que cobran tus clientes.
  2. Fija el periodo de dunning según tu ciclo de facturación. Un plan mensual no puede esperar tanto como uno anual.
  3. Elige deliberadamente la acción final para la suscripción y para la factura.
  4. Activa y reescribe los correos de dunning. Envía el primero en el primer fallo, con el enlace de actualización. En los rechazos duros, el correo es lo único que recuperará el pago.
  5. Trata el 3D Secure por separado. Di a esos clientes que su banco necesita que confirmen el pago, y envíales el enlace de inmediato.
  6. Activa el Self-Serve Portal para que los clientes que ignoran el correo puedan arreglar su tarjeta desde tu app.
  7. Activa los avisos de caducidad de tarjeta para detectar los fallos antes de que ocurran.
  8. Escucha payment_failed y payment_succeeded y registra el resultado por tipo de error, para ver qué fallos recupera tu configuración y cuáles no.

Qué añadir encima

Los reintentos y los correos de Chargebee cubren bien lo básico. Lo que te deja a ti es sobre todo la comunicación: correos que parezcan escritos por una persona, en el idioma del cliente, que digan qué hacer ante el fallo concreto; respuestas que lleguen a alguien; y un seguimiento de los clientes perdidos para intentar recuperarlos.

Hacerlo con NoChurn

NoChurn se conecta a tu sitio de Chargebee con una clave de API y sigue sus webhooks. Funciona junto a tus ajustes de dunning de Chargebee: envía correos de recuperación escritos por IA, revisados por ti, con un enlace para que el cliente actualice su medio de pago, y añade flujos de cancelación, correos de win-back a los 30, 60 y 90 días y un churn score de 0 a 100. La facturación, el cargo en sí y tu pasarela de pago siguen en Chargebee. Las disputas vienen de la pasarela que hay detrás de Chargebee; con Stripe o Braintree, NoChurn reúne las pruebas y redacta una respuesta que solo se envía después de que la revises. NoChurn es gratis por debajo de 300 € de MRR. Consulta NoChurn + Chargebee.

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