Afex Payments Entrar Criar conta
Recorrência

Cobrança recorrente: ciclo, retentativa e o risco de cobrar duas vezes

Assinatura parece simples até a primeira falha de cobrança. O que separa uma operação saudável de um problema é o que o sistema faz depois que a cobrança não passa.

Afex PaymentsAtualizado em 31/08/2026

Receita recorrente muda a matemática do negócio, mas traz um tipo de risco que a venda avulsa não tem: o mesmo cliente é cobrado repetidamente, de forma automática, sem ninguém olhando. Quando algo dá errado nesse laço, dá errado em escala.

O ciclo

Uma assinatura precisa de três definições: o valor, o intervalo e o método. O intervalo não precisa ser mensal. Ciclos em dias permitem desenhos que o mensal engessa, como planos semanais, quinzenais ou trimestrais, sem depender de calendário.

Na Afex Payments o intervalo é definido em dias, de 1 a 365, e a cobrança pode ser no cartão guardado em cofre tokenizado ou por Pix a cada ciclo.

Quando a cobrança falha

Falha de cobrança é rotina, não exceção. Cartão expirado, limite insuficiente, emissor fora do ar. O que importa é o comportamento do sistema a partir daí.

Sem retentativa, uma falha momentânea cancela um cliente que continuaria pagando. Com retentativa infinita, você irrita o cliente e acumula tentativas negadas, o que chama atenção do adquirente.

Na Afex Payments a régua é explícita: falhou, tenta de novo no dia seguinte, até 3 tentativas. Depois disso a assinatura passa para o estado de pendência, e a decisão volta a ser humana.

O risco que quase ninguém discute: cobrar duas vezes

Este é o ponto mais delicado de qualquer sistema de recorrência. A cobrança é disparada por um processo automático que varre as assinaturas vencidas. Se esse processo roda duas vezes por qualquer motivo, uma reinicialização, uma fila que reprocessa, um erro de rede que fez a chamada parecer perdida, o cliente pode ser cobrado duas vezes pelo mesmo mês.

Cobrança duplicada não é só estorno. É contestação, é confiança perdida e é atendimento.

O que resolve: idempotência por ciclo

A proteção correta é a cobrança carregar uma chave única que identifica aquele ciclo daquela assinatura, e não apenas a tentativa. Quando a chave inclui a data de vencimento, uma segunda varredura no mesmo dia devolve a mesma cobrança que já existe, em vez de criar outra.

É o tipo de detalhe invisível no material de vendas e decisivo na operação. Vale perguntar isso a qualquer provedor de recorrência que você avaliar.

Cartão salvo e segurança

Para cobrar de novo sem pedir os dados outra vez, o cartão precisa ficar guardado. O jeito seguro é o número nunca chegar ao servidor de quem vende: o dado é tokenizado no dispositivo do comprador, e o que fica salvo é um token que só serve para aquele estabelecimento.

Checklist antes de ligar recorrência

  1. Defina o ciclo em dias, não presuma mensal.
  2. Confirme a régua de retentativa: quantas tentativas e com qual intervalo.
  3. Pergunte como o provedor evita cobrança duplicada.
  4. Defina o que acontece quando a assinatura entra em pendência: corta acesso na hora ou tem carência.
  5. Verifique que o cartão é tokenizado e que você não guarda número nem CVV.

Perguntas frequentes

Quantas vezes o sistema tenta cobrar de novo?

Na Afex Payments, até 3 tentativas, uma por dia. Depois disso a assinatura entra em pendência.

O ciclo precisa ser mensal?

Não. O intervalo é definido em dias, de 1 a 365.

Como evitar cobrar o mesmo cliente duas vezes?

A cobrança precisa ser idempotente por ciclo: a chave que a identifica inclui a data de vencimento, então uma varredura repetida no mesmo dia devolve a mesma cobrança em vez de criar outra.

Comece a receber do Brasil e do mundo

Crie sua conta e aceite Pix, cartão nacional e internacional e métodos locais em mais de 40 países.

Criar conta grátis