PayPal · Códigos de recusa
O que significa o código de resposta do processador PayPal 5100?
Verificado em
O código de resposta do processador PayPal 5100 (GENERIC_DECLINE) significa que o cartão foi recusado sem um motivo específico. O banco ou uma verificação de risco o recusou e o PayPal repassou apenas este código geral. O comprador deve tentar outro cartão ou perguntar ao seu banco; o lojista pode tentar novamente uma vez após uma pausa, e então deve pedir um método de pagamento diferente.
- Rótulo do PayPal
- GENERIC_DECLINE
- Tipo
- Recusa suave
- Quem recusou
- O banco do cartão ou uma verificação de risco (via PayPal)
- Tentar novamente
- Uma vez, após 2–3 dias; uma segunda recusa significa pedir outro método de pagamento
- Ação do comprador
- Usar outro cartão ou perguntar ao banco
- Ação do lojista
- No máximo uma nova tentativa, depois outro método
- Renovação PlatformDTC (Smart retry)
- Uma nova tentativa após 48–72 horas, depois uma solicitação de atualização de cartão
O que a PlatformDTC faz
PlatformDTC mapeia 5100 para generic_decline: o banco disse não sem um motivo. Com o Smart retry ativado, uma renovação recebe uma única nova tentativa após 48–72 horas, e então o cliente é solicitado a usar outra forma de pagamento. O painel do lojista exibe "O banco recusou o pagamento sem dar um motivo."
Por que acontece
Uma recusa genérica é o que retorna quando ninguém na cadeia informa o motivo. Abrange filtros de fraude, regras bancárias e limites.
O que o comprador pode fazer
Tente um cartão diferente ou seu saldo do PayPal.
Seu banco pode explicar a recusa e pode aprovar uma segunda tentativa.
O que a loja pode fazer
Torne a troca de métodos fácil no momento da recusa.
Tente novamente um cartão salvo no máximo uma vez; depois disso, peça ao cliente para atualizá-lo.
Para desenvolvedores
O PayPal retorna 5100 em `processor_response.response_code` na captura (`purchase_units[].payments.captures[]`) ou autorização de um pagamento com cartão. O nome próprio do PayPal para isso é GENERIC_DECLINE.
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
- Por que os bancos não dão um motivo para 5100?
- Por privacidade e segurança, os bancos compartilham os detalhes de uma recusa apenas com o titular do cartão.
- 5100 deve ser tratado como fundos insuficientes?
- Não. O PayPal tem um código separado para isso (5120). Sem um motivo declarado, o PlatformDTC permite uma nova tentativa em vez do calendário de fundos mais longo.
Fontes
Relacionado
- 0500 — Não honrar: o banco do cartão recusou o pagamento e não deu nenhuma razão.
- 10BR — Emissor rejeitou: o banco do cartão recusou o pagamento.
- 9540 — Cartão recusado: o cartão foi recusado para este pagamento.
- 5110 — Falha de CVV2: o código de segurança do cartão não correspondeu.
- 5120 — Fundos insuficientes: o cartão não tem dinheiro ou crédito suficiente para este pagamento.
- 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.