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 |
|---|---|
| El pago de renovación falla | active → on_hold |
| El intento de reintento falla | permanece on_hold (el siguiente reintento se programa si la ventana lo permite) |
| El intento de reintento tiene éxito | on_hold → active, la próxima fecha de facturación se avanza |
| La ventana de recuperación se agota | permanece on_hold |
| Evento | Se activa cuando |
|---|---|
subscription.on_hold | Una renovación falla y la suscripción se coloca en espera |
subscription.active | Un reintento tiene éxito y la suscripción se reactiva |
Subscription Webhook Payloads
Consulta los esquemas de carga útil completa del webhook para eventos del ciclo de vida de la suscripción.
Fallas Reintentas vs. No Reintentas
| Tipo de falla | Ejemplos | ¿Reintenta? |
|---|---|---|
| Declinación suave | Fondos insuficientes, declinación genérica, límite de velocidad de la tarjeta excedido, error de procesamiento, error/tiempo de espera de la red, intenta 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 termina tan pronto como se observa una declinación dura. Combina los Reintentos de Pago con Gestión de Cobranza de Suscripciones para solicitar al cliente que actualice su método de pago en esos casos.
Reintentos de Pago vs. Gestión de Cobranza
Los Reintentos de Pago y Gestión de Cobranza de Suscripciones son herramientas de recuperación complementarias:| Reintentos de Pago | Gestión de Cobranza de Suscripciones | |
|---|---|---|
| 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 | El cliente actualiza el método de pago en el portal |
| Mejor para | Declinaciones temporales/suaves que se resuelven solas | Tarjetas expiradas o inválidas que necesitan reemplazo |
Relacionado
Subscription Dunning
Secuencias de correos electrónicos que invitan a los clientes a actualizar su método de pago.
Abandoned Cart Recovery
Recupera pagos únicos incompletos o fallidos con correos electrónicos dirigidos.
Subscriptions
Entiende los estados de suscripción involucrados en los flujos de recuperación.
Subscription Webhooks
Reacciona a los eventos
subscription.on_hold y subscription.active.