PayPal · Códigos de recusa
O que significa o código de resposta do processador PayPal 5120?
Verificado em
O código de resposta do processador PayPal 5120 (INSUFFICIENT_FUNDS) significa que o cartão não tinha saldo disponível ou crédito suficiente para cobrir o pagamento. É uma recusa suave: o mesmo cartão pode funcionar assim que o dinheiro for depositado ou a fatura for paga. O comprador pode recarregar, usar um valor menor ou pagar de outra forma; os lojistas devem tentar novamente mais tarde, idealmente após o dia de pagamento.
- Etiqueta PayPal
- INSUFFICIENT_FUNDS
- Tipo
- Recusa suave
- Quem recusou
- O banco do cartão (via PayPal)
- Código Visa similar
- 51 (Fundos insuficientes): Categoria 2 da Visa: novas tentativas permitidas, até 20 em 30 dias
- Tentar novamente
- Sim, após o próximo dia de pagamento do cliente ou recarga
- Ação do comprador
- Recarregar ou usar outro cartão
- Ação do lojista
- Tentar novamente mais tarde, idealmente após o dia de pagamento; oferecer outro método agora
- Renovação PlatformDTC (Smart retry)
- Escada PayPal: até 7 tentativas, com 3+ dias de intervalo, visando o dia de pagamento
O que a PlatformDTC faz
A PlatformDTC arquiva o PayPal 5120 como fundos insuficientes (como insufficient_funds). Com o Smart retry ativado, a renovação de uma assinatura PayPal segue a escada PayPal mais longa: até 7 tentativas, cada uma com pelo menos 3 dias de intervalo da última, movida para o próximo dia de pagamento do assinante quando um cair dentro de uma semana, dentro de uma janela de pelo menos 24 dias. O e-mail do cliente pede que ele tenha fundos prontos até a data da nova tentativa, e a assinatura é mantida em atraso, nunca cancelada, se todas as tentativas falharem.
Por que acontece
O saldo ou limite de crédito era insuficiente no momento da cobrança.
O que o comprador pode fazer
Adicionar dinheiro à conta ou cartão, ou usar outro cartão ou seu saldo PayPal.
O que a loja pode fazer
Para pedidos únicos, sugerir outro método imediatamente.
Para assinaturas, o tempo é mais importante que a repetição: tente novamente quando o cliente provavelmente tiver sido pago, não várias vezes em um dia.
Para desenvolvedores
O PayPal retorna 5120 em processor_response.response_code na captura (purchase_units[].payments.captures[]) ou autorização de um pagamento com cartão. O próprio nome do PayPal para isso é INSUFFICIENT_FUNDS.
A Visa tem um código de resposta bruto com nome similar, 51 ("Fundos insuficientes"); nas Regras Essenciais da Visa (24 de outubro de 2026, Tabela 7-2) esse código é da categoria 2: novas tentativas permitidas, até 20 em 30 dias. A lista de códigos do PayPal não mapeia seus códigos para os da Visa, então trate isso como contexto, não como uma tradução.
Pagamentos com cartão recusados também podem conter payment_advice_code em processor_response, o conselho da rede do cartão; armazene-o ao lado do código de resposta.
Perguntas frequentes
- Qual é o melhor momento para tentar novamente o 5120?
- Depois que o dinheiro provavelmente chegou, tipicamente no dia de pagamento do cliente. Tentativas rápidas e repetidas raramente ajudam e adicionam recusas ao seu registro.
- O 5120 significa que o cliente quer cancelar?
- Não. É um problema de saldo no dia da cobrança, e muitos desses clientes pagam assim que os fundos chegam.
Fontes
Relacionado
- PPAX — Valor excedido: o pagamento está acima de um limite no cartão ou conta.
- 5710 — Tentativas excedem o limite: muitas tentativas de pagamento neste cartão.
- PPEL — Excede limite de frequência: muitos pagamentos em um período neste cartão.
- 5140 — Cartão encerrado: a conta do cartão foi encerrada pelo banco ou pelo titular do cartão.
- 5150 — Recolher cartão, condições especiais: o banco quer que este cartão seja desativado.
- 5160 — Usuário não autorizado: a pessoa que está pagando não está autorizada a usar este cartão.
- 5170 — Falha AVS: o endereço de cobrança não correspondeu aos registros do banco.
- 5180 — Cartão inválido ou restrito: este cartão não pode ser usado; o PayPal diz para tentar outro.