As novas tentativas de pagamento repetem automaticamente os pagamentos de renovação de assinatura com falha seguindo uma programação de intervalos progressivos. Quando uma nova tentativa é bem-sucedida, a assinatura é reativada automaticamente — sem exigir nenhuma ação do cliente ou trabalho de integração.
O que são novas tentativas de pagamento?
Quando um pagamento de renovação de assinatura falha, a assinatura é colocada em espera. Com as novas tentativas de pagamento habilitadas, Dodo Payments cobra automaticamente o método de pagamento existente do cliente seguindo uma programação inteligente até que o pagamento seja bem-sucedido ou a janela de recuperação seja encerrada. Isso recupera a receita perdida devido a falhas temporárias — retenções de cartão expirado, fundos insuficientes que são adicionados posteriormente, erros transitórios de rede — sem enviar um e-mail ao cliente ou pedir que ele atualize qualquer informação.As novas tentativas de pagamento se aplicam somente a pagamentos de renovação de assinatura. Os pagamentos iniciais (configuração do mandato), pagamentos únicos, cobranças por alteração de plano e cobranças sob demanda não são repetidos por este recurso.
Como funcionam as novas tentativas de pagamento
1
Renewal fails
Um pagamento de renovação de assinatura falha e a assinatura passa para o estado
on_hold.2
Retryability check
O código de erro da falha é verificado. Recusas temporárias (fundos insuficientes, recusa genérica, erros de processamento ou de rede etc.) podem passar por novas tentativas. Recusas definitivas encerram imediatamente a cadeia de novas tentativas, pois repetir a tentativa não mudará o resultado.
3
Scheduled retry
Se a recusa puder passar por uma nova tentativa e a janela de recuperação permitir, a próxima tentativa será agendada. As novas tentativas são executadas fora da sessão usando o método de pagamento existente do cliente, seguindo uma programação de intervalos progressivos.
4
Recovery
Na primeira nova tentativa bem-sucedida, a assinatura retorna a
active e a próxima data de cobrança é avançada normalmente. Se a janela for encerrada antes que qualquer nova tentativa seja bem-sucedida, as novas tentativas são interrompidas e a assinatura permanece em espera.Configuração das novas tentativas de pagamento
Habilite e configure as novas tentativas de pagamento em Settings → Recovery no seu dashboard.
Payment Retries settings under Settings → Recovery
A janela de recuperação é baseada no momento em que a invoice de renovação com falha foi criada. As novas tentativas só são agendadas enquanto o atraso acumulado dos intervalos ainda couber na janela.
Programação das novas tentativas
Os intervalos entre as novas tentativas aumentam progressivamente. Até 8 tentativas são realizadas, desde que cada uma delas caiba na sua janela de recuperação:Transições de status da assinatura
Se uma assinatura for cancelada enquanto ainda houver novas tentativas agendadas, a cadeia de novas tentativas será encerrada imediatamente e nenhuma tentativa adicional será realizada. Outros status não ativos (
on_hold, expired, pending, failed) continuam passando por novas tentativas, pois suas invoices de renovação em aberto representam uma dívida referente a períodos que o cliente já consumiu.Subscription Webhook Payloads
Veja os schemas completos de payload dos webhooks para eventos do ciclo de vida da assinatura.
Falhas que podem ou não passar por novas tentativas
Tentar novamente uma recusa definitiva não mudará o resultado, portanto a cadeia de novas tentativas é encerrada assim que uma recusa definitiva é identificada. Combine as novas tentativas de pagamento com Subscription Dunning para solicitar que o cliente atualize o 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:
Habilitar ambos oferece a maior cobertura de recuperação: as novas tentativas automáticas capturam falhas transitórias, enquanto o dunning recupera clientes cujo método de pagamento realmente precisa ser atualizado.
Relacionados
Subscription Dunning
Sequências de e-mails que solicitam que os clientes atualizem seu método de pagamento.
Abandoned Cart Recovery
Recupere checkouts únicos incompletos ou com falha usando e-mails direcionados.
Subscriptions
Entenda os estados de assinatura envolvidos nos fluxos de recuperação.
Subscription Webhooks
Reaja aos eventos
subscription.on_hold e subscription.active.