Saltar al contenido principal
Los Reintentos de Pago vuelven a intentar automáticamente los pagos de renovación de suscripción fallidos siguiendo un cronograma de progresivo. Si un reintento tiene éxito, la suscripción se reactiva automáticamente, sin necesidad de acción del cliente o trabajo de integración.

¿Qué Son los Reintentos de Pago?

Cuando un pago de renovación de suscripción falla, la suscripción se coloca en espera. Con Reintentos de Pago habilitados, Dodo Payments vuelve a cargar automáticamente el método de pago existente del cliente según un cronograma inteligente hasta que el pago tenga éxito o se cierre la ventana de recuperación. Esto recupera los ingresos perdidos por fallos temporales — tarjetas expuestas, fondos insuficientes que se reponen, errores transitorios de red — sin enviar correos electrónicos al cliente ni solicitarle que actualice nada.
Los Reintentos de Pago solo se aplican a pagos de renovación de suscripción. Los primeros pagos (configuración de mandato), pagos únicos, cargos por cambio de plan y cargos a demanda no se reintentan con esta función.

Cómo Funcionan los Reintentos de Pago

1

Renewal fails

Un pago de renovación de suscripción falla y la suscripción se mueve al estado on_hold.
2

Retryability check

Se revisa el código de error de la falla. Las declinaciones suaves (fondos insuficientes, declinación genérica, errores de procesamiento o red, etc.) son reintentables. Las declinaciones duras terminan la cadena de reintentos inmediatamente, ya que reintentar no cambiará el resultado.
3

Scheduled retry

Si la declinación es reintenible y la ventana de recuperación lo permite, se programa el siguiente intento. Los reintentos se realizan fuera de sesión contra el método de pago existente del cliente según un cronograma de progresivo.
4

Recovery

En el primer reintento exitoso, la suscripción vuelve a active y la próxima fecha de facturación se avanza con normalidad. Si la ventana se cierra antes de que cualquier reintento tenga éxito, los reintentos se detienen y la suscripción permanece en espera.

Configuración de Reintentos de Pago

Habilita y configura los Reintentos de Pago desde Configuración → Recuperación en tu panel de control.
Página de Configuración de Recuperación con la opción de habilitar activada y un campo de ventana de recuperación (días) configurado en 13

Payment Retries settings under Settings → Recovery

La ventana de recuperación está anclada al momento en que se creó la factura de renovación fallida. Los reintentos solo se programan mientras el retraso acumulativo todavía encaje dentro de la ventana.

Programa de Reintentos

Los reintentos se retrasan de manera progresiva. Se realizan hasta 8 intentos, siempre que cada uno encaje dentro de tu ventana de recuperación:
Una ventana de recuperación de 13 días (la predeterminada) cubre los intentos 1 a 5 (el intento 5 se realiza ~10.5 días después del fallo). Aumenta la ventana hacia el máximo de 30 días si deseas que se realicen los intentos posteriores, más ampliamente espaciados (6 a 8).

Transiciones de Estado de Suscripción

Si una suscripción se cancela mientras aún hay reintentos programados, la cadena de reintentos termina inmediatamente y no se realizan más intentos. Otros estados no activos (on_hold, expired, pending, failed) continúan intentando, porque sus facturas de renovación abiertas representan una deuda por períodos que el cliente ya ha consumido.
Estas transiciones emiten los eventos estándar de suscripción webhook, para que pueda gestionar la lógica de derechos sin manejo especial de reintentos:

Subscription Webhook Payloads

Vea los esquemas completos de carga útil de webhook para eventos del ciclo de vida de suscripción.

Fallas Reintentables vs. No Reintentables

Reintentar una declinación dura no cambiará el resultado, por lo que la cadena de reintentos se termina tan pronto como se observa una declinación dura. Combine Reintentos de Pago con Recuperación de Suscripción para solicitar al cliente que actualice su método de pago en esos casos.

Reintentos de Pago vs. Recuperación

Los Reintentos de Pago y Recuperación de Suscripción son herramientas complementarias de recuperación: Habilitar ambos le brinda la cobertura de recuperación más amplia: los reintentos automáticos capturan fallas transitorias, mientras que la recuperación recupera a los clientes cuyo método de pago realmente necesita ser actualizado.

Relacionado

Subscription Dunning

Secuencias de correos electrónicos que solicitan a los clientes que actualicen su método de pago.

Abandoned Cart Recovery

Recupere compras únicas incompletas o fallidas con correos electrónicos específicos.

Subscriptions

Comprenda los estados de suscripción involucrados en los flujos de recuperación.

Subscription Webhooks

Reaccione a los eventos subscription.on_hold e subscription.active.
Última modificación el 26 de junio de 2026