Stripe · Códigos de recusa
O que significa o código de recusa insufficient_funds da Stripe?
Verificado em
O código de recusa insufficient_funds da Stripe significa que o cartão tem fundos insuficientes para concluir a compra. O cartão é válido, mas o saldo ou crédito disponível não pode cobrir o valor no momento. A Stripe diz que o cliente precisa usar um método de pagamento alternativo. Em assinaturas, uma nova tentativa posterior, programada para quando o dinheiro provavelmente estiver de volta na conta, pode ter sucesso. A Visa permite novas tentativas, até 20 em 30 dias.
- Tipo
- Recusa suave
- Quem recusou
- O banco do cartão
- Tentar novamente
- Sim, mais tarde (dias, não minutos)
- Ação do comprador
- Use outro cartão ou método, ou adicione fundos e tente novamente
- Ação do lojista
- Tentar novamente em um agendamento; sugerir outro método de pagamento
O que a PlatformDTC faz
No checkout, a PlatformDTC mostra "Seu cartão tem fundos insuficientes. Tente outro cartão." e não usa um processador de backup, que atingiria o mesmo saldo. Com o Smart retry ativado, uma renovação é tentada novamente na próxima provável data de pagamento do assinante para seu país (ou 2, 5, 8, 13 e 18 dias após a primeira recusa), às 14:00 do horário deles, até 6 tentativas. Cartões pré-pagos recebem uma nova tentativa na data de pagamento.
Por que acontece
O saldo da conta ou limite de crédito está abaixo do valor do pagamento quando o banco o verifica.
O que o comprador pode fazer
Pague com outro cartão, PayPal ou outro método, ou adicione dinheiro à conta e tente novamente.
O que a loja pode fazer
Para pedidos únicos, mostre outras opções de pagamento imediatamente. Para renovações, tente novamente nos dias seguintes em vez de imediatamente; a Stripe recomenda não mais de oito novas tentativas para cobranças que permitem novas tentativas, e os emissores podem tratar novas tentativas extras como possível fraude.
Para desenvolvedores
O código bruto da Visa é 51 (Categoria 2: nova tentativa permitida, até 20 tentativas em 30 dias). A Mastercard envia 51 com um Merchant Advice Code; MAC 24–30 nomeiam uma espera exata de 1 hora a 10 dias, e 03 significa não tentar novamente. Um generic_decline também pode estar sobre um 51 bruto.
Perguntas frequentes
- Devo tentar novamente uma recusa por insufficient_funds?
- Sim, mas mais tarde. Uma nova tentativa minutos após uma recusa por fundos pede o mesmo saldo baixo novamente. Espere dias, idealmente até que o cliente provavelmente tenha sido pago, e nunca tente novamente mais de uma vez por dia.
- Quantas vezes posso tentar novamente insufficient_funds na Visa?
- As regras da Visa (edição de 24 de outubro de 2026) permitem até 20 novas tentativas em 30 dias para o código 51. A Stripe recomenda um máximo de oito novas tentativas.
- insufficient_funds é uma recusa dura?
- Não. O cartão funciona; ele apenas não pode cobrir este valor no momento.
Fontes
Relacionado
- card_velocity_exceeded — O saldo, limite de crédito ou limite de valor do cartão foi atingido.
- withdrawal_count_limit_exceeded — O cliente excedeu o saldo ou limite de crédito disponível no cartão.
- generic_decline — Recusado por um motivo desconhecido, ou bloqueado pelo Stripe Radar ou Adaptive Acceptance.
- do_not_honor — O banco recusou o cartão sem dizer o porquê.
- invalid_account — O cartão ou a conta vinculada a ele não é mais válido.
- invalid_amount — O valor do pagamento é inválido ou acima do que o cartão permite.
- invalid_cvc — O código de segurança do cartão (CVC) está incorreto.
- invalid_expiry_month — O mês de validade do cartão é inválido.