Subscription Dunning envia e-mails aos clientes cuja assinatura expirou após um pagamento recusado ou que a cancelaram, solicitando que atualizem o método de pagamento ou comprem novamente. Ele é executado automaticamente assim que você o ativa.
O que é Gestão de Inscrições?
Dunning detecta quando uma assinatura entra em um estado recuperável e envia uma sequência de e-mails solicitando que o cliente tome uma ação. Três estados iniciam uma sequência:- Assinaturas On Hold: um pagamento de renovação falhou, por exemplo, devido a fundos insuficientes ou a um cartão expirado.
- Assinaturas Past Due: um pagamento de renovação falhou enquanto um período de carência está ativo.
- Assinaturas Cancelled: o cliente cancelou pelo Customer Portal.
Como Funciona a Gestão de Inscrições
1
Trigger
Uma assinatura entra em um dos três estados:
- On Hold: um pagamento de renovação falhou.
- Past Due: um pagamento de renovação falhou enquanto um período de carência está ativo.
- Cancelled: o cliente cancelou a assinatura pelo Customer Portal.
dunning.started. Nenhuma tentativa é iniciada quando a sequência correspondente não tem e-mails ativados, e uma assinatura pode ter no máximo uma tentativa ativa por vez.2
Grace Period
Se você definir um período de carência, uma renovação com falha move a assinatura para
past_due em vez de on_hold.A sequência de e-mails de On Hold é executada durante esse período, para que o cliente seja solicitado a pagar enquanto ainda tem acesso.Um pagamento recusado inicia uma sequência. O fim do período não inicia uma segunda sequência. Se o período terminar com a assinatura em On Hold, os e-mails restantes da sequência ainda serão enviados. Se terminar com a assinatura cancelada, a tentativa será marcada como exhausted.A tentativa de dunning registra um estado de acionamento past_due. Ao consultar as análises de dunning, filtre por past_due e também por on_hold.3
Email Sequence
Com base no estado de acionamento, Dodo Payments envia até 4 e-mails de dunning nos intervalos que você configurar. Cada e-mail contém um link para o Customer Portal, onde o cliente pode atualizar o método de pagamento, ou para um checkout onde pode comprar novamente uma assinatura cancelada.
4
Recovery
Quando o cliente atualiza o método de pagamento no Customer Portal, Dodo Payments cobra automaticamente os valores pendentes. Se o pagamento for aprovado, a assinatura será reativada e a tentativa de dunning será marcada como
recovered.Ciclo de vida dos status
Cada tentativa de dunning tem um destes status:Quando uma tentativa de dunning é marcada como
exhausted, Dodo Payments não altera a assinatura. Ela permanece no estado atual (past due, on hold ou cancelled).Configurando o Dunning
Ative e configure o Dunning em Settings → Recovery no seu dashboard. O Dunning fica desativado por padrão.
Dunning settings in the dashboard showing enable toggle, on-hold sequence, and cancelled sequence
Sequências de e-mails
O Dunning tem duas sequências de e-mails, On Hold e Cancelled, cada uma com até 4 e-mails. O dashboard as lista como E-mails enviados ao cliente quando a assinatura está em on hold e E-mails enviados ao cliente quando a assinatura é cancelada. Uma tentativapast_due usa a sequência On Hold.
Cada e-mail tem estas configurações:
Em Linha de assunto, Dodo Payments substitui estes placeholders:
{store_name}, {store_owner_name}, {store_contact_email}, {subscription_id}, {failure_reason} e {payment_form_link}.
Os intervalos padrão são:
Exemplos de e-mails de Dunning
O Dunning envia um e-mail diferente para cada estado da assinatura. Estes exemplos mostram o que o cliente vê.- On Hold
- Cancelled
Dunning email sent when a renewal payment fails and the subscription is on hold
Experiência de recuperação do cliente
Quando um cliente clica no link de um e-mail de dunning de on hold, o Customer Portal abre na assinatura dele. Ali, ele pode ver o status da assinatura e atualizar o método de pagamento.
Customer portal showing an on-hold subscription with option to update payment method
active.
Para uma assinatura cancelada, o link abre uma página de checkout com o produto da assinatura já adicionado ao carrinho.
Análises
Acompanhe o desempenho do Dunning em Analytics → Recovery no seu dashboard.
Recovery analytics dashboard showing ACR and dunning metrics
Eventos de webhook
O Dunning envia dois eventos de webhook:Recovery Webhook Payloads
Consulte os schemas completos do payload dos webhooks para eventos de dunning.
Casos extremos
O Dunning trata automaticamente destes casos:Práticas recomendadas
- Comece com os padrões: os intervalos padrão (1, 3, 5 e 7 dias) distribuem os e-mails ao longo de uma semana, para que os clientes não recebam mensagens em excesso, mas ainda vejam lembretes regulares.
- Monitore as taxas de recuperação: confira Taxa de recuperação por e-mail para ver qual e-mail gera mais recuperações. Se os e-mails posteriores recuperarem quase nada, desative-os.
- Coordene com o suporte: informe à sua equipe de suporte que os e-mails de dunning estão sendo enviados, para que ela possa ajudar os clientes que responderem.
- Revise os estados das assinaturas: combine o dunning com os webhooks
subscription.on_holdesubscription.cancelledpara acompanhar todo o ciclo de vida da assinatura.
O Dunning funciona em conjunto com os fluxos existentes de on hold e reativação no Customer Portal. Depois que você o ativa, ele é executado automaticamente, sem necessidade de trabalho de integração.
Conteúdo relacionado
Recovery Webhooks
Reaja aos eventos
dunning.started e dunning.recovered.Abandoned Cart Recovery
Recupere checkouts abandonados ou com falha com e-mails de recuperação.
Customer Portal
Os clientes atualizam seus métodos de pagamento no Customer Portal.
Subscriptions
Os estados das assinaturas que acionam o dunning.