Recusa genérica (generic decline): o que significa e o que fazer a seguir
Uma recusa genérica é uma recusa de cartão sem motivo. Como distinguir a recusa do banco de um bloqueio antifraude, quando repetir e o que dizer ao cliente.

Uma recusa genérica (generic decline) significa que o pagamento foi recusado sem nenhum motivo específico. Na maioria dos casos, o banco do cliente disse que não e guardou o motivo para si; só o titular do cartão o pode obter, contactando o banco. No Stripe, porém, generic_decline também pode significar que o banco nunca viu o pagamento, porque o Stripe Radar ou o Adaptive Acceptance o bloquearam antes. Por isso, antes de tentar de novo ou de pedir a um cliente que ligue para o banco, verifique onde o pagamento parou.
Este guia explica o que o código significa no Stripe, Braintree, Adyen e Recurly, como distinguir uma recusa do banco emissor de um bloqueio do seu próprio fornecedor, quando uma nova tentativa é permitida e o que escrever ao cliente. Cada regra abaixo vem da documentação dos próprios fornecedores, listada nas fontes.
O que significa uma recusa genérica?
Quando um pagamento com cartão é enviado para autorização, o banco emissor responde com um código de resposta. Alguns códigos são específicos: saldo insuficiente, cartão expirado, CVC incorreto. Outros dizem apenas “recusado”. O guia do Stripe sobre recusas de cartão di-lo claramente: os bancos emissores classificam a maioria das recusas como genéricas, “o que torna pouco claro o motivo exato da recusa”. Acrescenta que, por razões de privacidade e segurança, os bancos emissores só discutem os detalhes de uma recusa com os titulares dos cartões.
Uma recusa genérica não é, portanto, um diagnóstico. Por trás dela pode estar um filtro de fraude do banco, um limite, falta de saldo, um cartão bloqueado para pagamentos online ou uma regra interna. Não é possível saber qual pelo código, e o seu fornecedor de pagamentos também não.
O Stripe descreve generic_decline assim: “O cartão foi recusado por um motivo desconhecido ou o Stripe Radar ou o Adaptive Acceptance bloquearam o pagamento.” O passo seguinte que indica é que o cliente tem de contactar o banco emissor do cartão para mais informações. O seu primo próximo, do_not_honor, tem o mesmo passo seguinte, mas só a primeira metade da descrição: “recusado por um motivo desconhecido”. Para esse código, veja o guia sobre “do not honor”.
O pagamento chegou sequer ao banco?
Esta é a pergunta que a maioria das equipas salta. A visão geral do Stripe sobre recusas lista três motivos para um pagamento falhar: recusas do banco emissor, pagamentos bloqueados e chamadas à API inválidas. Diz que, quando o Stripe bloqueia um pagamento, “não obtém autorização do banco emissor do cartão”. Pedir ao cliente que ligue para o banco por causa de um pagamento que o banco nunca recebeu faz perder tempo ao cliente e a si.
No Stripe, o objeto outcome da cobrança diz-lhe em que caso está:
outcome.type |
outcome.network_status |
O que aconteceu | O que fazer |
|---|---|---|---|
issuer_declined |
declined_by_network |
O banco recusou o pagamento | Leia o código de recomendação; tente mais tarde ou peça outro cartão |
blocked |
not_sent_to_network |
O Stripe bloqueou-o antes do banco (Radar ou Adaptive Acceptance) | Veja outcome.reason e as suas regras do Radar; ligar para o banco não ajuda |
invalid |
not_sent_to_network |
A própria chamada à API estava errada | Corrija o pedido; nada a dizer ao cliente |
Para um pagamento bloqueado, outcome.reason diz porquê: highest_risk_level para a regra de bloqueio predefinida do Radar, rule para uma das suas regras personalizadas e low_probability_of_authorization quando o Adaptive Acceptance considerou improvável que o pagamento fosse autorizado. O campo outcome.seller_message dá uma frase como “O Stripe bloqueou esta cobrança por ser demasiado arriscada.”
Outros fornecedores fazem a mesma separação, com as suas próprias palavras:
- O Braintree distingue uma recusa do processador, que “indica que o banco do cliente recusou o pedido de transação”, de uma rejeição do gateway, que é “bloqueada pelas definições do seu gateway Braintree” (ferramentas de fraude, regras de CVV ou AVS, duplicados, limiares de risco e outros). Uma rejeição do gateway mostra o estado “Gateway Rejected” com um motivo.
- A Adyen devolve o motivo de recusa
2“Refused” para uma recusa simples, e20“FRAUD” quando as suas verificações de risco antes da autorização deram uma pontuação de fraude de 100 ou mais. - A Recurly agrupa os erros por categoria.
declinedestá em Soft; códigos comofraud_gateway(“recusou a transação devido aos filtros de fraude ativados no seu gateway”) efraud_risk_checkestão em Fraud.
Se fatura com Chargebee, Zuora ou Maxio por cima de um destes gateways, procure o código do próprio gateway nos detalhes do erro do pagamento: é aí que a separação aparece.
- 01 Verificar onde parou outcome.type e network_status: recusa do banco ou bloqueio do seu próprio fornecedor
- 02 Ler o advice code try_again_later, do_not_try_again ou confirm_card_data
- 03 Tentar de novo, com dias de intervalo Dentro dos limites das redes, nunca em sequência rápida
- 04 Pedir outro cartão Ou um contacto com o banco; tentar de imediato quando o cartão for atualizado
Como é que cada fornecedor chama a uma recusa genérica?
| Onde | Recusa genérica | Orientação sobre novas tentativas na documentação |
|---|---|---|
| Stripe | decline_code: generic_decline (também do_not_honor) |
Leia outcome.advice_code |
| Braintree | 2046 Declined; também 2000 Do Not Honor e 2038 Processor Declined |
Os três marcados como soft |
| Adyen | Motivo de recusa 2 “Refused” |
Não indicada na página dos motivos de recusa |
| Recurly | declined, também declined_saveable (“recusado sem informação específica”) |
Listados em Soft |
Dois detalhes ajudam a ler estes códigos:
- O texto do Braintree para
2000 Do Not Honorchama-lhe uma “recusa genérica”, e para2046 Declineddiz para contactar o banco nos pagamentos com cartão, o PayPal Support para PayPal e o Venmo Support para Venmo. - A Adyen tem um motivo de recusa separado,
27“Declined Non Generic”, para respostas que “não podem ser mapeadas de forma fiável”. A Adyen diz que isto torna mais fácil distinguir as recusas genéricas, como o “05: Do not honor” da Mastercard, das mais específicas.
Deve tentar de novo uma recusa genérica?
Normalmente sim, um número limitado de vezes e de forma espaçada, a não ser que um código de recomendação diga para parar. O Braintree e a Recurly classificam os seus códigos genéricos como recusa temporária (soft decline), que uma nova tentativa mais tarde pode resolver, mas é o código de recomendação que a acompanha que tem a última palavra.
No Stripe, leia outcome.advice_code:
try_again_later: o banco emissor recusou, mas pode tentar de novo.do_not_try_again: não volte a usar o cartão para esta transação.confirm_card_data: alguns dados do cartão estão errados; o cliente tem de os verificar.
Um bloqueio do Radar também traz um código de recomendação: o exemplo do Stripe de um pagamento bloqueado mostra do_not_try_again. Tentar de novo sem alterações só voltaria a esbarrar na mesma regra.
Limites das redes de cartões. O artigo do Braintree sobre recusas indica as categorias de novas tentativas da Visa tal como se aplicam aos seus comerciantes. 2000 Do Not Honor está na Categoria 4 e 2046 Declined na Categoria 2; ambos estão limitados a 15 novas tentativas 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 até 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” por novas tentativas excessivas.
Na prática, para uma renovação que falha com uma recusa genérica:
- Verifique primeiro
outcome.type. Se o pagamento foi bloqueado pelo seu próprio fornecedor, reveja a regra; não agende novas tentativas. - Nunca tente de novo em ciclo rápido. O mesmo pedido um minuto depois tem grande probabilidade de receber a mesma resposta, e conta para os limites das redes.
- Espace as novas tentativas por dias. Se a causa escondida era falta de saldo ou um limite diário, outro dia tem mais hipóteses.
- Pare perante um sinal “do not try again” (
do_not_try_againdo Stripe, MAC03ou21da Mastercard) e peça outro método de pagamento. - Tente de novo de imediato quando o cliente atualizar o cartão, em vez de esperar pela próxima tentativa agendada.
Como o Stripe, o Chargebee, a Recurly e outros agendam as novas tentativas é comparado em calendários de novas tentativas de pagamento comparados.
O que deve dizer ao cliente?
Diga-lhe que o banco recusou o pagamento e dê-lhe duas saídas: contactar o banco ou usar outro cartão. Nunca mostre “generic_decline” nem um código em bruto.
Uma mensagem genérica é também a opção segura quando o verdadeiro motivo é sensível. A referência do Stripe diz para apresentar as recusas fraudulent, lost_card, stolen_card e merchant_blacklist da mesma forma que generic_decline, sem mais detalhes. 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 declined segue o mesmo padrão: “A sua transação foi recusada. Use um cartão diferente ou contacte o seu banco.”
Um email de renovação para uma recusa do banco emissor 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]. Os bancos nem sempre dizem porquê. Muitas vezes é um bloqueio temporário que uma chamada ou mensagem rápida para o seu banco resolve.
Também pode usar outro cartão aqui: [link de atualização]
Vamos tentar novamente a [data]. Se o seu banco levantar o bloqueio antes disso, não precisa de fazer nada.
Para um pagamento bloqueado pelas suas próprias regras de fraude, o email é diferente: não mande o cliente para o banco. Se o cliente parecer legítimo depois da análise, peça-lhe que tente de novo ou que use outro método de pagamento, ou ajuste a regra. Encontra mais modelos em os códigos de recusa do Stripe explicados.
Que erros deve evitar?
- Tratar cada recusa genérica como culpa do banco. No Stripe, verifique
outcome.typeenetwork_statusantes de escrever ao cliente. - Tentar de novo um pagamento bloqueado. Uma regra do Radar ou do gateway voltará a bloquear o mesmo pedido.
- Ignorar o código de recomendação. A mesma recusa genérica pode vir com “try again later” ou “do not try again”.
- Pedir ao cliente que volte a introduzir os dados do cartão sem verificar. O Stripe diz para examinar as verificações de CVC e de morada (AVS) quando um cartão devolve uma recusa genérica ou
do_not_honor, e para pedir ao cliente que confirme esses dados se uma verificação falhou. - Revelar o verdadeiro motivo. Se o código por trás da mensagem genérica for
stolen_cardoufraudulent, o cliente continua a ver uma recusa genérica.
Como testar uma recusa genérica?
O cartão de teste do Stripe 4000000000000002 devolve um erro card_declined com o código de recusa generic_decline. Use-o em modo de teste para verificar que o seu checkout mostra a mensagem certa e que o seu fluxo de renovação envia o email, agenda a nova tentativa e para 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 uma recusa genérica, 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 “recusa genérica” num pagamento com cartão?
O pagamento foi recusado sem um motivo específico. Normalmente, o banco do cliente recusou-o e só partilha o motivo com o titular do cartão. No Stripe, generic_decline também pode significar que o Stripe Radar ou o Adaptive Acceptance bloquearam o pagamento antes de chegar ao banco.
Uma recusa genérica é o mesmo que “do not honor”?
São próximas. Ambas são recusas sem motivo indicado, e o Stripe dá a ambas o mesmo passo seguinte: o cliente contacta o banco. A diferença no Stripe é que generic_decline também cobre pagamentos bloqueados pelo Radar ou pelo Adaptive Acceptance.
Pode tentar de novo uma recusa genérica?
Normalmente sim, se esperar e o código de recomendação o permitir. O Braintree marca os seus códigos genéricos como soft, e a Visa limita estas categorias a 15 novas tentativas em 30 dias móveis. Pare perante do_not_try_again do Stripe ou os MAC 03 ou 21 da Mastercard.
Como sei se o Stripe Radar bloqueou o pagamento?
Veja o outcome da cobrança. Um bloqueio do Radar tem type: blocked e network_status: not_sent_to_network, com um reason como highest_risk_level ou rule. Uma recusa do banco emissor tem type: issuer_declined e network_status: declined_by_network.
Porque é que o banco não me diz o motivo?
O Stripe afirma que, por razões de privacidade e segurança, os bancos emissores só discutem os detalhes de uma recusa com os titulares dos cartões. O seu fornecedor transmite os códigos que recebe, nada mais.
Fontes
Todas consultadas a 17 de novembro de 2026.