Quantas novas tentativas manuais de cobrança posso fazer em uma assinatura?

Você pode cobrar uma assinatura manualmente sempre que precisar. Cada cartão aceita até 5 tentativas recusadas em 24 horas e até 12 em 30 dias, somando suas cobranças manuais e as novas tentativas automáticas. Cobranças aprovadas não contam.

Esse limite protege o seu negócio: cuida da sua reputação perante os bancos emissores e protege você das multas das bandeiras de cartão. Ele se aplica da mesma forma a todos os estabelecimentos.

Como as tentativas são contadas

• Até 5 tentativas recusadas em 24 horas no mesmo cartão.

• Até 12 tentativas recusadas em 30 dias no mesmo cartão.

• Todas as tentativas recusadas contam: suas cobranças manuais pelo dashboard ou pela API, as novas tentativas automáticas e as cobranças de cada ciclo.

• O limite é contado por cartão, não por assinatura. Se o mesmo cartão paga duas assinaturas, as recusas das duas somam.

• As duas janelas são móveis: contam para trás a partir do momento de cada tentativa.

Nossas novas tentativas automáticas seguem um calendário fixo de 4 tentativas em 10 dias, então também somam ao limite. Consulte Como funciona a lógica de novas tentativas.

Como fazer uma nova tentativa manual

Pelo dashboard, abra a assinatura e processe a cobrança. Abre-se a janela de confirmação da cobrança, onde você define a data da próxima cobrança e confirma.

Pela API, use POST /v3/subscriptions/{id}/pay.

Uma cobrança manual não consome as novas tentativas automáticas: elas mantêm o seu próprio calendário.

O que acontece quando o cartão chega ao limite

Não enviamos a cobrança ao banco: retemos antes, para não somar outra recusa. O cartão volta a ficar disponível sozinho, assim que a recusa mais antiga sai da janela.

No dashboard, um aviso informa que o pagamento não pôde ser processado porque o limite de tentativas dos últimos 30 dias foi atingido, e mostra a data e a hora em que você poderá tentar de novo, no seu horário local.

Pela API, a resposta é um 400 com uma mensagem como esta:

Para a janela de 24 horas, a mensagem diz "5 in the last 24 hours (maximum 5)". Na API, a data está em UTC: converta para o seu fuso horário (por exemplo, em Brasília são 3 horas a menos).

Nas cobranças automáticas, se o cartão estiver no limite quando chegar a data da cobrança, reprogramamos a tentativa para o dia seguinte.

Por que esse limite existe

• Sua reputação perante os bancos emissores. Cada tentativa recusada em um cartão fica registrada. Quando um estabelecimento insiste demais, os bancos passam a tratar suas cobranças com mais desconfiança, e isso afeta também os clientes que pagam em dia.

• Retenções temporárias do banco. Diante de muitas tentativas seguidas, o banco emissor pode reter o cartão por 24 a 72 horas e recusar qualquer cobrança nesse período, até mesmo uma legítima.

• Regras das bandeiras. Visa e Mastercard definem limites de novas tentativas e aplicam multas a quem os excede.

Aplica-se desde 1º de outubro de 2026, da mesma forma para todos os estabelecimentos, porque segue as regras das bandeiras de cartão.

O que você pode fazer quando um cartão chega ao limite

1. Aguarde a data indicada na mensagem. Não é necessária nenhuma ação para o cartão voltar a ficar disponível.

2. Se as recusas forem por saldo insuficiente, peça ao seu cliente que atualize o meio de pagamento. Nos detalhes da assinatura no seu dashboard, você pode enviar o link para ele trocar o cartão.

3. Se o seu cliente cadastrar um cartão novo, você pode cobrar na hora. O limite é por cartão, então um cartão diferente começa do zero.

4. Evite novas tentativas depois de recusas definitivas, como um cartão informado como roubado, bloqueado ou perdido. Essas recusas não se resolvem com mais tentativas.

Precisa de ajuda?

Se a mensagem aparecer em um cartão sem recusas recentes, ou se uma cobrança automática não foi reprogramada depois da data indicada, fale conosco em support@rebill.com com o identificador da assinatura, que começa com sub_.