As Novas Tentativas de Pagamento reagem automaticamente a falhas nos pagamentos de renovação de assinaturas em uma programação progressiva. Quando uma nova tentativa é bem-sucedida, a assinatura é reativada automaticamente — sem ação do cliente ou trabalho de integração necessário.
O que São Novas Tentativas de Pagamento?
Quando o pagamento de renovação de uma assinatura falha, a assinatura é colocada em espera. Com as Novas Tentativas de Pagamento habilitadas, o Dodo Payments cobra novamente o método de pagamento existente do cliente em uma programação inteligente até que o pagamento seja bem-sucedido ou a janela de recuperação se feche. Isso recupera a receita perdida devido a falhas temporárias — cartões expirados, fundos insuficientes que são recarregados, erros de rede transitórios — sem enviar e-mails ao cliente ou solicitar que atualizem qualquer coisa.As Novas Tentativas de Pagamento aplicam-se apenas aos pagamentos de renovação de assinaturas. Pagamentos iniciais (configuração de mandato), pagamentos únicos, cobranças por mudança de plano e cobranças sob demanda não são abrangidos por este recurso.
Como Funcionam as Novas Tentativas de Pagamento
Renewal fails
Um pagamento de renovação de assinatura falha e a assinatura passa para o estado
on_hold.Retryability check
O código de erro da falha é verificado. Falhas suaves (fundos insuficientes, recusa genérica, erros de processamento ou de rede, etc.) são passíveis de nova tentativa. Falhas graves terminam imediatamente a cadeia de novas tentativas, já que tentar novamente não mudará o resultado.
Scheduled retry
Se a falha for passível de nova tentativa e a janela de recuperação permitir, a próxima tentativa é agendada. Novas tentativas ocorrem fora da sessão contra o método de pagamento existente do cliente em uma programação progressiva.
Configurando Novas Tentativas de Pagamento
Habilite e configure Novas Tentativas de Pagamento em Configurações → Recuperação no seu dashboard.
| Configuração | Descrição | Padrão |
|---|---|---|
| Habilitar Novas Tentativas de Pagamento | Tente novamente automaticamente os pagamentos de renovação de assinaturas que falharam para recuperar receita. | Desligado (opt-in) |
| Janela de Recuperação (dias) | Quanto tempo continuar tentando um pagamento falhado antes de desistir. Deve ser entre 1 e 30. | 13 |
Cronograma de Novas Tentativas
As novas tentativas recuam progressivamente. Até 8 tentativas são feitas, desde que cada uma se encaixe dentro da sua janela de recuperação:| Tentativa | Atraso após tentativa anterior | Tempo aproximado desde a falha |
|---|---|---|
| 1 | 12 horas | 12 horas |
| 2 | 24 horas | 36 horas |
| 3 | 48 horas | ~3,5 dias |
| 4 | 72 horas | ~6,5 dias |
| 5 | 96 horas | ~10,5 dias |
| 6 | 120 horas | ~15,5 dias |
| 7 | 7 dias | ~22,5 dias |
| 8 | 7 dias | ~29,5 dias |
Transições de Status de Assinatura
| Evento | Status da assinatura |
|---|---|
| Falha no pagamento da renovação | active → on_hold |
| Falha na tentativa de nova tentativa | permanece on_hold (próxima tentativa agendada se a janela permitir) |
| Sucesso na tentativa de nova tentativa | on_hold → active, próxima data de cobrança avançada |
| Janela de recuperação exaurida | permanece on_hold |
| Evento | Ocorre quando |
|---|---|
subscription.on_hold | Uma renovação falha e a assinatura é colocada em espera |
subscription.active | Uma nova tentativa tem sucesso e a assinatura é reativada |
Subscription Webhook Payloads
Veja os esquemas completos de payload de webhook para eventos do ciclo de vida da assinatura.
Falhas Passíveis de Nova Tentativa vs. Não Passíveis de Nova Tentativa
| Tipo de falha | Exemplos | Tentativa de nova? |
|---|---|---|
| Falha suave | Fundos insuficientes, rejeição genérica, velocidade de cartão excedida, erro de processamento, erro de rede/tempo excedido, tente novamente mais tarde | Sim |
| Falha grave | Cartão roubado/perdido, cartão inválido, não honrar, conta fechada e outras recusas terminais | Não — cadeia termina imediatamente |
Tentar novamente uma falha grave não mudará o resultado, então a cadeia de novas tentativas termina assim que uma falha grave é observada. Combine Novas Tentativas de Pagamento com Subscription Dunning para solicitar ao cliente que atualize seu método de pagamento nesses casos.
Novas Tentativas de Pagamento vs. Dunning
As Novas Tentativas de Pagamento e o Subscription Dunning são ferramentas complementares de recuperação:| Novas Tentativas de Pagamento | Subscription Dunning | |
|---|---|---|
| Mecanismo | Recarrega silenciosamente o método de pagamento existente | Envia e-mails ao cliente para atualizar seu método de pagamento |
| Ação do cliente | Nenhuma necessária | Cliente atualiza método de pagamento no portal |
| Melhor para | Falhas temporárias/suaves que se resolvem sozinhas | Cartões expirados ou inválidos que precisam ser substituídos |
Relacionados
Subscription Dunning
Sequências de e-mail que solicitam aos clientes que atualizem seu método de pagamento.
Abandoned Cart Recovery
Recupere checkouts únicos ou falhados com e-mails direcionados.
Subscriptions
Compreenda os estados de assinatura envolvidos nos fluxos de recuperação.
Subscription Webhooks
Reaja aos eventos
subscription.on_hold e subscription.active.