A renovação da assinatura chega, o cartão salvo falha e o assinante some do MRR — muitas vezes sem ter pedido cancelamento. Retentativa de cobrança é tentar de novo o mesmo meio (com intervalo e limite); dunning é o pacote completo: retentativa + aviso + link para trocar o cartão + outro meio de pagamento.
Este guia fecha o fluxo para SaaS, academia, curso e clube: por que o plástico falha, quantas vezes tentar, como o dunning difere da régua de cobrança e o que a AbacatePay faz de forma nativa. O mapa dos códigos (reversível x irreversível) está em códigos de recusa do cartão.
Por que o cartão da assinatura falha
Na renovação, o emissor pode negar por limite estourado, cartão vencido, plástico trocado no app do banco, bloqueio temporário ou restrição do produto. A classificação reversível x irreversível da ABECS define se vale insistir no mesmo cartão ou pedir um novo — detalhe em códigos de recusa do cartão.
Retentativa automática só faz sentido em recusa reversível (ou depois de o cliente corrigir o dado). Em irreversível — validade errada, número inválido, perdido/roubado — a próxima tentativa útil é outro cartão ou outro meio, não a mesma autorização em loop.
Contexto de recorrência: pagamento recorrente. Gateway para SaaS: guia.
Churn involuntário e MRR
Churn involuntário é o assinante que não quis sair, mas a cobrança falhou e a assinatura acabou cancelada. Diferente do cancelamento consciente, ele drena MRR sem feedback de produto: o cliente descobriu o corte quando o acesso sumiu.
Por isso recuperação de cobrança importa tanto quanto aquisição. Cada renovação salva reduz churn que a operação poderia ter evitado com retentativa, aviso e troca de cartão a tempo. Sem inventar taxa de recuperação: meça no seu painel quantas falhas voltaram a pagar e quantas viraram cancelamento.
Retentativa de cobrança: quantas vezes e em que intervalo
Retentativa é a nova tentativa de autorizar o mesmo cartão após uma falha, com intervalo entre tentativas e um teto máximo. Em assinaturas na AbacatePay:
- Quando a cobrança do ciclo falha, a plataforma tenta de novo sozinha
- Padrão: 3 tentativas no total, com 1 dia de intervalo — renovação no dia, nova tentativa +1 dia, última +2 dias (não é “primeira + 3 extras”)
- Configurável em cada checkout de assinatura com
retryPolicy:maxRetryde 1 a 10 eretryEveryde 1 a 30 dias - Se a última falhar, a assinatura é cancelada para não cobrar o próximo ciclo
Só faz sentido retentar recusa reversível. Irreversível pede cartão novo (ou Pix Automático / Pix avulso), não mais do mesmo plástico. Documentação: criar assinatura e referência.
Fale com o time sobre assinaturas e retentativa.
Dunning: retentativa + aviso + link para trocar o cartão + outro meio
Dunning (gestão de cobrança falha) junta quatro peças:
- Retentativa no cartão (política acima)
- Aviso ao assinante de que a renovação falhou
- Link para trocar o cartão na área do cliente
- Outro meio para o ciclo em atraso ou para a mensalidade seguinte
Régua de cobrança é outra peça: sequência de avisos em torno do vencimento (lembrete antes, cobrança depois). Em cartão recorrente, a régua de mensagens entra depois das retentativas falharem. Guia: régua de cobrança. Reduzir atraso no geral: como reduzir inadimplência.
Na AbacatePay, use o webhook da falha para disparar os avisos da sua loja (e-mail, SMS ou o canal que você já opera). O evento chega no seu endpoint; a loja monta a mensagem.
Trocar o meio: Pix Automático
Se o cartão vira atrito recorrente, Pix Automático é meio de assinatura: o pagador autoriza uma vez e as cobranças seguintes são agendadas. Boleto não é meio de assinatura na AbacatePay.
Para recuperar um ciclo já em atraso sem mudar o meio da assinatura, um link de pagamento com Pix avulso cobre aquele valor. No checkout de compra avulsa, se o cartão falhar na hora, Pix na mesma tela evita perder a sessão.
A retentativa nativa descrita neste post é a do cartão em assinatura — não transporte a mesma política automaticamente para o Pix Automático.
Segmentos: /saas, /para/academias.
Como funciona na AbacatePay
Fluxo documentado (consultado em 08/11/2026):
Retentativa — falhou a cobrança do ciclo → novas tentativas conforme retryPolicy → esgotou maxRetry → assinatura cancelada com cancelledDueTo "max_payment_retries_exceeded". Veja /assinaturas.
Webhooks — a cada falha: subscription.payment_failed com retryNumber (quantas tentativas já foram feitas). Passou em qualquer tentativa: subscription.renewed. Estourou o máximo: subscription.cancelled com o motivo acima. Eventos: webhooks de assinatura. O lojista sabe que falhou e em qual tentativa, não o motivo detalhado da recusa do emissor.
Troca de cartão — a loja gera pela API um link da área do cliente; o cliente entra com código enviado por e-mail e troca o cartão. Havendo cobrança em atraso, ela é cobrada no cartão novo na hora; se for recusada, o cartão não é trocado. Cancelamento pelo cliente vale no fim do período já pago. Doc: customer portal.
Cartão é liberado sob consulta — a ativação não é automática.
Métricas para acompanhar
Acompanhe no seu export ou painel (conceitos — sem benchmark inventado):
- Taxa de recuperação — entre as cobranças que falharam na primeira tentativa, quantas pagaram em alguma retentativa ou após troca de cartão
- Churn involuntário — cancelamentos por esgotamento de tentativas (
max_payment_retries_exceeded) sobre a base ativa - Receita recuperada — soma dos ciclos que teriam se perdido sem retentativa / dunning
O número que vale é o da sua base. Para o desenho do MRR: o que é MRR.
Perguntas frequentes
Quantas vezes posso tentar cobrar o mesmo cartão?
Na AbacatePay o padrão são 3 tentativas no total (renovação + duas seguintes), com 1 dia entre elas. Você configura maxRetry (1–10) e retryEvery (1–30 dias) em cada checkout de assinatura. Fora do produto, a ABECS distingue recusa reversível e irreversível — ver códigos de recusa.
A retentativa pode cobrar o cliente duas vezes?
Timeout ou erro de rede não é recusa: a cobrança pode ter sido aprovada sem resposta. Espere o webhook (subscription.renewed ou subscription.payment_failed) ou consulte o status antes de disparar tentativa manual. Repetir às cegas aumenta o risco de cobrança duplicada.
Quando cancelar a assinatura por falta de pagamento?
Na política nativa, depois da última tentativa sem sucesso a assinatura já é cancelada automaticamente, para não cobrar o próximo ciclo. Se você opera régua própria, alinhe o cancelamento ao fim do maxRetry e ao aviso final — e use régua de cobrança só para as mensagens, não como substituto da retentativa.
Vale trocar o cartão por Pix Automático na mensalidade?
Para quem vive renovação falha por limite ou cartão trocado, Pix Automático reduz dependência do plástico. É meio de assinatura na AbacatePay (junto com cartão); boleto não é. Avalie no seu ticket e no hábito do assinante.
Dunning é a mesma coisa que régua de cobrança?
Não. Dunning cobre a falha de renovação (retentar, avisar, trocar cartão, mudar meio). Régua de cobrança é a sequência de avisos de vencimento. Em cartão, a régua de mensagens costuma entrar depois das retentativas. Detalhe: régua de cobrança.
Fale com o time sobre assinaturas e recuperação de cobrança.
Leia também: códigos de recusa do cartão · régua de cobrança · pagamento recorrente · o que é MRR · como reduzir inadimplência · gateway para SaaS · cartão recusado: Pix na mesma tela · assinaturas · Pix Automático · área do cliente · link de pagamento