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.

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:
- 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.
- 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).
- 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
- 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.
- Fija el periodo de dunning según tu ciclo de facturación. Un plan mensual no puede esperar tanto como uno anual.
- Elige deliberadamente la acción final para la suscripción y para la factura.
- 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.
- 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.
- Activa el Self-Serve Portal para que los clientes que ignoran el correo puedan arreglar su tarjeta desde tu app.
- Activa los avisos de caducidad de tarjeta para detectar los fallos antes de que ocurran.
- Escucha
payment_failedypayment_succeededy 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.