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
Renewal fails
Un pago de renovación de suscripción falla y la suscripción se mueve al estado
on_hold.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.
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.
Configuración de Reintentos de Pago
Habilita y configura los Reintentos de Pago desde Configuración → Recuperación en tu panel de control.
| Configuración | Descripción | Predeterminado |
|---|---|---|
| Habilitar Reintentos de Pago | Volver a intentar automáticamente los pagos de renovación de suscripción fallidos para recuperar ingresos. | Desactivado (opcional) |
| Ventana de recuperación (días) | Cuánto tiempo seguir reintentando un pago fallido antes de desistir. Debe estar entre 1 y 30. | 13 |
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:| Intento | Retraso después del intento anterior | Tiempo aproximado desde el fallo |
|---|---|---|
| 1 | 12 horas | 12 horas |
| 2 | 24 horas | 36 horas |
| 3 | 48 horas | ~3.5 días |
| 4 | 72 horas | ~6.5 días |
| 5 | 96 horas | ~10.5 días |
| 6 | 120 horas | ~15.5 días |
| 7 | 7 días | ~22.5 días |
| 8 | 7 días | ~29.5 días |
Transiciones de Estado de Suscripción
| Evento | Estado de la suscripción |
|---|---|
| Falla en el pago de renovación | active → on_hold |
| Falla en el intento de reintento | permanece on_hold (se programa otro reintento si la ventana lo permite) |
| Éxito en el intento de reintento | on_hold → active, próxima fecha de facturación avanzada |
| Ventana de recuperación agotada | permanece on_hold |
| Suscripción cancelada | los reintentos programados se detienen inmediatamente (terminal — no más intentos) |
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.| Evento | Se dispara cuando |
|---|---|
subscription.on_hold | Falla una renovación y la suscripción se coloca en espera |
subscription.active | Un reintento tiene éxito y la suscripción se reactiva |
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
| Tipo de fallo | Ejemplos | ¿Reintentado? |
|---|---|---|
| Declinación suave | Fondos insuficientes, declinación genérica, límite de tarjeta excedido, error de procesamiento, error de red/tiempo de espera, inténtelo de nuevo más tarde | Sí |
| Declinación dura | Tarjeta robada/perdida, tarjeta inválida, no honrar, cuenta cerrada, y otras declinaciones terminales | No — la cadena termina inmediatamente |
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:| Reintentos de Pago | Recuperación de Suscripción | |
|---|---|---|
| Mecanismo | Recarga silenciosamente el método de pago existente | Envía correos electrónicos al cliente para actualizar su método de pago |
| Acción del cliente | No se requiere ninguna | El cliente actualiza su método de pago en el portal |
| Mejor para | Declinaciones temporales/suaves que se resuelven solas | Tarjetas caducadas o inválidas que necesitan ser reemplazadas |
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.