Card velocity exceeded: o que significa esta recusa e o que fazer
Card velocity exceeded: o cartão atingiu um limite do banco. O que significa no Stripe, Braintree, Adyen e Recurly, e quando tentar de novo o pagamento.

“Card velocity exceeded” significa que o banco do cliente recusou o pagamento porque o cartão atingiu um dos seus limites: o saldo ou o limite de crédito, um limite ao montante por transação ou por período, ou um limite ao número de vezes que o cartão pode ser usado. Não é um alerta de fraude do seu lado, e o cartão não está inutilizado. O cliente pode pedir ao banco que levante o limite, esperar que ele seja reposto ou pagar com outro cartão, por isso uma nova tentativa espaçada resulta muitas vezes.
Este guia explica como se chama esta recusa no Stripe, Braintree, Adyen e Recurly, em que difere das regras de “velocity” das suas próprias ferramentas antifraude, quantas novas tentativas as redes de cartões permitem e o que dizer ao cliente. Cada regra abaixo vem da documentação dos próprios fornecedores, listada nas fontes.
O que significa “card velocity exceeded”?
Nos pagamentos, a “velocity” é o montante gasto com um cartão, ou a frequência com que é usado, ao longo de um período. Os bancos emissores põem limites a ambos e, quando um pagamento ultrapassaria um deles, recusam-no.
O código de recusa card_velocity_exceeded do Stripe diz: “O cliente excedeu o saldo, o limite de crédito ou o limite de montante por transação disponível no seu cartão.” O passo seguinte que o Stripe indica é que o cliente tem de contactar o banco emissor do cartão para mais informações.
Um só código cobre, portanto, várias situações, e não é possível saber pelo código qual delas se aplica:
- O limite de crédito ou o saldo está esgotado. Num cartão de crédito, o saldo em dívida mais a sua cobrança fica acima do limite.
- Um limite de montante. O banco limita quanto o cartão pode gastar numa só transação ou ao longo de um período, como um dia.
- Um limite de número. O banco limita quantas transações o cartão pode fazer ao longo de um período.
As respostas em bruto dos adquirentes da Adyen indicam as duas respostas de limite que estão por trás deste tipo de recusa: 61 “Exceeds withdrawal amount limit(s)”, em que “o comprador excedeu o limite do cartão”, e 65 “Exceeds withdrawal count limit”, em que o comprador “excedeu o limite de frequência de utilização do cartão”. Nos dois casos, a Adyen diz que o comprador pode tentar de novo depois de resolver o problema com o banco, ou usar outro método de pagamento.
É o mesmo que saldo insuficiente?
Parecido, mas não igual. O Stripe tem um código separado, insufficient_funds: “O cartão não tem saldo suficiente para concluir a compra.” O passo seguinte também é diferente: o cliente tem de usar um método de pagamento alternativo, enquanto card_velocity_exceeded o manda para o banco.
O Stripe lista também withdrawal_count_limit_exceeded: “O cliente excedeu o saldo ou o limite de crédito disponível no seu cartão”, com o mesmo passo seguinte que insufficient_funds. Na prática, trate os três como a mesma família: uma recusa temporária (soft decline) ligada a dinheiro ou a limites, que outro dia ou outro cartão podem resolver.
Em que difere das suas próprias regras de velocity?
A palavra “velocity” aparece também nas ferramentas antifraude, e aí é outra coisa. Uma recusa por card velocity vem do banco do cliente. Uma regra de velocity na sua ferramenta antifraude é sua: bloqueia um cartão, um email ou um endereço IP que tenta demasiados pagamentos num curto espaço de tempo.
A Recurly mostra bem a separação. O seu código fraud_velocity está em Fraud: “A transação fazia parte de um volume elevado vindo de uma única origem, o que indica uma possível atividade fraudulenta.” O seu código too_many_attempts, em Soft, significa que o pagamento “foi recusado devido a demasiadas tentativas de autorização”, e a mensagem para o cliente pede-lhe que espere antes de voltar a tentar com o cartão.
A solução não é a mesma:
| Onde está o limite | Exemplo | Quem o pode levantar |
|---|---|---|
| O banco do cliente | card_velocity_exceeded do Stripe, 2002 do Braintree, 28 ou 29 da Adyen |
O cliente, com o seu banco, ou o tempo |
| A sua ferramenta antifraude | fraud_velocity da Recurly, uma regra de velocity no Stripe Radar ou no seu gateway |
A sua equipa, revendo a regra |
| A sua própria conta de comerciante | merch_max_transaction_limit_exceeded da Recurly |
A sua equipa, com o seu gateway |
A última linha é rara, mas convém conhecê-la: merch_max_transaction_limit_exceeded da Recurly significa que “o limite foi excedido para o seu montante diário ou mensal em dólares ou em transações”, um limite da sua conta no gateway, não do cartão do cliente. O conselho da Recurly é contactar o gateway para aumentar o montante do limite. Dizer ao cliente que ligue para o banco não ajudaria.
Como se chama em cada fornecedor?
| Onde | Código | Tipo na documentação |
|---|---|---|
| Stripe | card_velocity_exceeded; primos próximos withdrawal_count_limit_exceeded e insufficient_funds |
Sem tipo indicado; leia o código de recomendação |
| Braintree | 2002 Limit Exceeded, 2003 Cardholder's Activity Limit Exceeded |
Soft, Categoria 2 da Visa |
| Adyen | Motivo de recusa 28 “Withdrawal amount exceeded”, 29 “Withdrawal count exceeded” |
As respostas em bruto 61 e 65 dizem que o comprador pode tentar de novo depois de resolver o limite |
| Recurly | exceeds_daily_limit, exceeds_max_amount |
Soft |
A explicação do Braintree para 2002 é que a transação “excede o limite de levantamento da conta”, e para 2003 que “excede o limite de atividade da conta”. Para ambos, diz que o cliente terá de contactar o banco para alterar os limites da conta ou usar outro método de pagamento.
Se fatura com Chargebee, Zuora, Maxio ou Paddle por cima de um gateway, procure o código do próprio gateway nos detalhes do erro do pagamento: é aí que verá qual destes recebeu. Para a lista completa do Stripe, veja os códigos de recusa do Stripe explicados.
Deve tentar de novo uma recusa por card velocity?
Sim, algumas vezes e espaçadas por vários dias, a não ser que o código de recomendação diga para parar. Um limite desaparece quando o cliente paga o saldo do cartão, quando o período é reposto ou quando o banco o aumenta. Outra tentativa no mesmo minuto esbarra no mesmo limite.
- 01 Ler o advice code try_again_later permite nova tentativa; do_not_try_again significa parar
- 02 Nenhuma tentativa no mesmo dia Um limite diário volta a recusar o mesmo pagamento
- 03 Poucas tentativas espaçadas por dias Dentro das oito do Stripe e das 15 em 30 dias da Visa
- 04 O banco ou outro cartão Tentar de imediato quando o cartão for atualizado ou o limite levantado
No Stripe, leia primeiro outcome.advice_code. try_again_later significa que o banco emissor recusou, mas pode tentar de novo. do_not_try_again significa que não deve voltar a usar o cartão para a mesma transação. O código de recomendação tem a última palavra sobre qualquer regra geral.
Limites das redes de cartões. O Braintree coloca 2002 e 2003 na Categoria 2 da Visa, “Issuer Cannot Approve At this Time (Reattempt Allowed)”, com as novas tentativas limitadas a 15 em 30 dias móveis. Acima do limite, a taxa é de 0,10 $ por transação nacional e 0,15 $ por transação internacional. Para a Mastercard, o Braintree diz que as novas tentativas “devem basear-se apenas nos Merchant Advice Codes”, e a Mastercard cobra 0,10 $ por cada nova tentativa além de 10 em 24 horas para os MAC 03 e 21.
O limite do próprio Stripe é mais baixo. O seu guia sobre recusas de cartão recomenda um máximo de oito novas tentativas para as cobranças que as permitem, e avisa que os bancos emissores podem ver as tentativas a mais como potencial fraude, o que pode causar mais recusas em cobranças legítimas. A Adyen tem um motivo de recusa, 46, para transações que ela própria bloqueou “para garantir que não lhe são cobradas taxas de penalização”.
Um calendário adequado a esta recusa:
- Nenhuma nova tentativa no mesmo dia. Se a causa for um limite diário, o mesmo dia voltará a falhar.
- Distribua algumas tentativas por vários dias, bem abaixo das oito do Stripe e das 15 em 30 dias da Visa. O Stripe Smart Retries, o Chargebee, a Recurly e outros têm cada um o seu calendário; são comparados em calendários de novas tentativas de pagamento comparados.
- Tente de novo de imediato quando o cliente atualizar o cartão ou disser que o banco levantou o limite, em vez de esperar pela próxima tentativa agendada.
- Pare perante um sinal “do not try again” (
do_not_try_againdo Stripe, MAC03ou21da Mastercard) e peça outro método de pagamento.
Porque é que as subscrições esbarram nos limites dos cartões?
Alguns padrões de faturação tornam as recusas por limite mais prováveis. Nenhum deles é motivo para mudar os seus preços, mas cada um tem uma solução simples:
- Renovações anuais. Doze meses cobrados de uma vez são o pagamento com mais probabilidade de ultrapassar um limite de montante. Um lembrete antes da renovação dá ao cliente tempo para libertar margem no cartão; veja lembretes de renovação de planos anuais.
- Várias cobranças no mesmo dia. Um extra, uma fatura de utilização e o plano base cobrados como pagamentos separados contam como várias transações para um limite de número. Se a sua ferramenta de faturação o permitir, junte-os numa só fatura.
- Grandes upgrades a meio do ciclo. Uma cobrança proporcional de upgrade soma-se à renovação. Se o upgrade falhar por um limite, mantenha o cliente no plano atual em vez de cancelar o que quer que seja.
- Novas tentativas em ciclo. Cada tentativa falhada conta para os limites de novas tentativas das redes indicados acima, e o Stripe avisa que os bancos emissores podem ver as tentativas a mais como potencial fraude. Um ciclo apertado só piora as coisas.
O que deve dizer ao cliente?
Diga-lhe que o banco recusou o pagamento por causa de um limite do cartão e dê-lhe duas saídas: pedir ao banco que levante o limite ou usar outro cartão. Nunca mostre card_velocity_exceeded nem um código em bruto. A página da Adyen sobre os motivos de recusa diz para não expor aos compradores os detalhes do motivo de recusa, “para evitar uma utilização maliciosa”.
A mensagem da Recurly para o cliente em caso de exceeds_daily_limit mostra o tom certo: “Esta transação excede o seu limite diário de aprovação. Contacte o seu banco ou tente outro cartão.”
Um email de renovação pode ser assim:
Assunto: O seu pagamento de [Produto] não foi concluído
Olá [Nome],
O seu banco recusou o pagamento deste mês de [montante] para [Produto] porque ultrapassa um limite do seu cartão. Normalmente é um limite de gastos ou de transações, que o seu banco pode levantar ou aumentar.
Também pode usar outro cartão aqui: [link de atualização]
Vamos tentar novamente a [data]. Se o limite for reposto ou se o seu banco o aumentar antes disso, não precisa de fazer nada.
Não faça alusões ao saldo ou ao crédito do cliente. “Um limite do seu cartão” é exato e educado; “já não tem dinheiro” pode estar errado e não lhe diz respeito.
Que erros deve evitar?
- Tratá-la como fraude. Uma recusa por card velocity vem dos limites do banco, não de um sinal de fraude. Não bloqueie o cliente nem o cartão.
- Confundi-la com as suas próprias regras de velocity. Se o código for
fraud_velocityou uma regra do Radar, a solução está do seu lado, não do lado do cliente. - Tentar de novo no mesmo dia. Um limite diário voltará a recusar o mesmo pagamento, e cada tentativa conta para os limites das redes.
- Cancelar depois de uma só falha. É uma recusa temporária. Dê tempo às novas tentativas e aos emails antes de a subscrição terminar.
- Pedir ao cliente que volte a introduzir os mesmos dados do cartão. O problema não são os dados, é um limite. Peça uma chamada para o banco ou outro cartão.
Como testar uma recusa por card velocity?
O cartão de teste do Stripe 4000000000006975 devolve um erro card_declined com o código de recusa card_velocity_exceeded (também disponível como pm_card_visa_chargeDeclinedVelocityLimitExceeded). Use-o em modo de teste para verificar que o seu checkout mostra uma mensagem clara e que o seu fluxo de renovação envia o email, espera antes da nova tentativa e tenta de novo de imediato quando o cartão é atualizado.
Como o NoChurn ajuda
O NoChurn lê o código de recusa e o histórico de cada renovação falhada. Para recusas temporárias como um limite do cartão, as novas tentativas acontecem nos dias prováveis de pagamento de salários, no fuso horário do cliente, dentro dos dias e horas que permitir; ou mantém as novas tentativas do seu fornecedor, como o Stripe Smart Retries. Os emails de recuperação saem por defeito nos dias 0, 3, 7 e 14, cada um escrito por IA para esse cliente e essa recusa, e verificado antes de sair; nunca mostram o código em bruto, e cada um tem um link para uma página alojada de atualização do cartão, sem login. Veja pagamentos falhados.
FAQ
O que significa “card velocity exceeded”?
O banco do cliente recusou o pagamento porque o cartão atingiu um dos seus limites: o saldo ou o limite de crédito, um limite ao montante gasto ou um limite à frequência com que o cartão pode ser usado. O Stripe devolve-a como card_velocity_exceeded.
Pode tentar de novo uma recusa card velocity exceeded?
Normalmente sim, se o código de recomendação o permitir e espaçar as tentativas por vários dias. O Braintree marca os códigos correspondentes 2002 e 2003 como soft e Categoria 2 da Visa: no máximo 15 novas tentativas em 30 dias móveis. O Stripe recomenda no máximo oito.
Quanto tempo dura um limite de card velocity?
Depende do banco emissor. Alguns limites são repostos ao fim de um dia ou de outro período, e um limite de crédito desaparece quando o cliente paga o saldo do cartão. Só o banco do cliente sabe, e é por isso que o passo seguinte indicado pelo Stripe é contactar o banco emissor do cartão.
Card velocity exceeded é sinal de fraude?
Não. Vem do banco do cliente, que aplica limites ao cartão. As ferramentas antifraude também usam regras de “velocity”, como fraud_velocity da Recurly, mas essas são as suas próprias regras e mostram códigos diferentes.
Em que difere de saldo insuficiente?
No Stripe, insufficient_funds significa que o cartão não tem saldo suficiente e o passo seguinte é outro método de pagamento. card_velocity_exceeded é mais amplo: um limite de saldo, de crédito ou de transação, e o passo seguinte é o cliente contactar o banco.
Fontes
Todas consultadas a 18 de novembro de 2026.