Dunning envía correos electrónicos a los clientes cuya suscripción venció después de un pago fallido o que la cancelaron, y les pide que actualicen su método de pago o vuelvan a comprar. Se ejecuta automáticamente una vez que lo activas.
¿Qué es la gestión de suscripciones fallidas?
Dunning detecta cuándo una suscripción entra en un estado recuperable y envía una secuencia de correos electrónicos que piden al cliente que actúe. Tres estados inician una secuencia:- Suscripciones On Hold: Un pago de renovación falló, por ejemplo, debido a fondos insuficientes o a una tarjeta vencida.
- Suscripciones Past Due: Un pago de renovación falló mientras hay un período de gracia abierto.
- Suscripciones Cancelled: El cliente canceló desde el Customer Portal.
Cómo funciona la gestión de suscripciones fallidas
1
Trigger
Una suscripción entra en uno de los tres estados:
- On Hold: Un pago de renovación falló.
- Past Due: Un pago de renovación falló mientras hay un período de gracia abierto.
- Cancelled: El cliente canceló su suscripción desde el Customer Portal.
dunning.started. No se inicia ningún intento cuando la secuencia correspondiente no tiene correos electrónicos activados, y una suscripción puede tener como máximo un intento activo a la vez.2
Grace Period
Si estableces un período de gracia, una renovación fallida mueve la suscripción a
past_due en lugar de a on_hold.La secuencia de correos electrónicos de On Hold se ejecuta durante ese período, por lo que se pide al cliente que pague mientras aún tiene acceso.Un pago fallido inicia una secuencia. El final del período no inicia una segunda secuencia. Si el período termina con la suscripción en estado On Hold, los correos restantes de la secuencia se siguen enviando. Si termina con la suscripción en estado Cancelled, el intento se marca como exhausted.El intento de Dunning registra un estado de activación past_due. Cuando leas los análisis de Dunning, filtra también por past_due, además de on_hold.3
Email Sequence
Según el estado de activación, Dodo Payments envía hasta 4 correos electrónicos de Dunning con los retrasos que configures. Cada correo enlaza al Customer Portal, donde el cliente puede actualizar su método de pago, o a un checkout donde puede volver a comprar una suscripción cancelada.
4
Recovery
Cuando el cliente actualiza su método de pago en el Customer Portal, Dodo Payments cobra automáticamente los importes pendientes. Si el pago se realiza correctamente, la suscripción se reactiva y el intento de Dunning se marca como
recovered.Ciclo de vida de los estados
Cada intento de Dunning tiene uno de estos estados:Cuando un intento de Dunning se marca como
exhausted, Dodo Payments no cambia la suscripción. Esta permanece en su estado actual (past due, on hold o cancelled).Configuración de Dunning
Activa y configura Dunning en Settings → Recovery en tu dashboard. Dunning está desactivado de forma predeterminada.
Dunning settings in the dashboard showing enable toggle, on-hold sequence, and cancelled sequence
Secuencias de correos electrónicos
Dunning tiene dos secuencias de correos electrónicos, On Hold y Cancelled, cada una con hasta 4 correos. El dashboard las muestra como Emails sent to customer when subscription is on hold y Emails sent to customer when subscription is cancelled. Un intentopast_due utiliza la secuencia On Hold.
Cada correo electrónico tiene estos ajustes:
En Subject Line, Dodo Payments reemplaza estos placeholders:
{store_name}, {store_owner_name}, {store_contact_email}, {subscription_id}, {failure_reason} y {payment_form_link}.
Los retrasos predeterminados son:
Ejemplos de correos electrónicos de Dunning
Dunning envía un correo electrónico diferente para cada estado de suscripción. Estos ejemplos muestran lo que ve el cliente.- On Hold
- Cancelled
Dunning email sent when a renewal payment fails and the subscription is on hold
Experiencia de recuperación del cliente
Cuando un cliente hace clic en el enlace de un correo electrónico de Dunning de On Hold, el Customer Portal se abre en su suscripción. Allí puede consultar el estado de la suscripción y actualizar su método de pago.
Customer portal showing an on-hold subscription with option to update payment method
active.
En el caso de una suscripción cancelada, el enlace abre una página de checkout con el producto de la suscripción ya incluido en el carrito.
Análisis
Consulta el rendimiento de Dunning en Analytics → Recovery en tu dashboard.
Recovery analytics dashboard showing ACR and dunning metrics
Eventos de Webhook
Dunning envía dos eventos de webhook:Recovery Webhook Payloads
Consulta los esquemas completos del payload de webhook para los eventos de Dunning.
Casos especiales
Dunning gestiona automáticamente estos casos:Prácticas recomendadas
- Comienza con los valores predeterminados: Los retrasos predeterminados (1, 3, 5 y 7 días) distribuyen los correos durante una semana, para que los clientes no reciban demasiados mensajes, pero sigan viendo recordatorios periódicos.
- Supervisa las tasas de recuperación: Consulta Recovery rate by email para ver qué correo genera más recuperaciones. Si los correos posteriores recuperan muy poco, desactívalos.
- Coordínate con el equipo de soporte: Informa a tu equipo de soporte de que se están enviando correos de Dunning para que pueda ayudar a los clientes que respondan.
- Revisa los estados de las suscripciones: Combina Dunning con los webhooks
subscription.on_holdysubscription.cancelledpara realizar un seguimiento del ciclo de vida completo de la suscripción.
Dunning funciona junto con los flujos existentes de On Hold y reactivación en el Customer Portal. Una vez que lo activas, se ejecuta automáticamente sin necesidad de trabajo de integración.
Relacionado
Recovery Webhooks
Responde a los eventos
dunning.started y dunning.recovered.Abandoned Cart Recovery
Recupera checkouts abandonados o fallidos con correos electrónicos de recuperación.
Customer Portal
Los clientes actualizan sus métodos de pago en el Customer Portal.
Subscriptions
Los estados de suscripción que activan Dunning.