PayPal · Códigos de recusa
O que significa o erro PayPal INSTRUMENT_DECLINED?
Verificado em
O erro INSTRUMENT_DECLINED do PayPal significa que a fonte de financiamento que o comprador escolheu, um cartão ou conta bancária em sua carteira PayPal, foi recusada pelo processador ou banco, ou não pode ser usada para este pagamento. O PayPal lista causas como um endereço de cobrança incorreto, um cartão acima do limite ou uma recusa bancária. A solução é reiniciar o pagamento para que o comprador possa escolher outra fonte de financiamento.
- Descrição do PayPal
- O instrumento apresentado foi recusado pelo processador ou banco, ou não pode ser usado para este pagamento.
- Tipo
- Recusa suave
- Quem recusou
- O processador ou banco por trás da fonte de financiamento do PayPal
- Tentar novamente
- Sim, alguns dias depois; mude o método se repetir
- Ação do comprador
- Escolha outro cartão ou banco no PayPal e pague novamente
- Ação do lojista
- Reinicie o pagamento para que o comprador possa escolher outra fonte
- 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 trata INSTRUMENT_DECLINED como uma recusa genérica do PayPal. Com o Smart retry ativado, uma renovação de assinatura do PayPal recusada dessa forma 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. Quando as tentativas se esgotam, a assinatura é mantida como vencida, não cancelada. Em pagamentos com cartão PayPal, qualquer código de processador que a PlatformDTC não mapeia também é registrado como INSTRUMENT_DECLINED, com o código bruto mantido.
Por que acontece
O PayPal retorna isso quando a fonte de financiamento do pagador falha: o cartão ou banco dentro de sua carteira PayPal disse não. O guia de falha de financiamento do PayPal lista um endereço de cobrança incorreto, uma transação acima do limite do cartão e uma recusa do emissor do cartão como exemplos.
O que o comprador pode fazer
Volte ao PayPal e escolha um cartão, conta bancária diferente ou seu saldo do PayPal.
Ou verifique o endereço de cobrança e o limite do cartão, e tente novamente.
O que a loja pode fazer
Reinicie o fluxo de pagamento para que o comprador veja as opções de financiamento do PayPal novamente; não mostre apenas um erro.
Em renovações, espaçar as tentativas ao longo dos dias; o saldo do comprador pode se recuperar até o dia de pagamento.
Para desenvolvedores
Quando você captura do seu servidor e a API Orders retorna INSTRUMENT_DECLINED (em `details[0].issue` do corpo do erro), reinicie o pagamento: no JavaScript SDK, chame `actions.restart()` dentro de `onApprove`. O PayPal diz que reiniciar é necessário se você chamar a API Orders diretamente do seu servidor.
Se você capturar com `actions.order.capture()` no navegador, o script do PayPal reinicia o fluxo de checkout automaticamente e solicita ao pagador que escolha outra fonte de financiamento.
Perguntas frequentes
- Devo tentar novamente INSTRUMENT_DECLINED?
- No checkout, reinicie para que o comprador possa escolher outra fonte de financiamento, como o PayPal recomenda. Para assinaturas, tentativas espaçadas dão tempo para o cartão ou saldo do comprador se recuperar, já que o PayPal não menciona nenhuma razão que descarte a recuperação.
- INSTRUMENT_DECLINED significa que a conta PayPal do comprador está sendo bloqueada?
- Não. É sobre o cartão ou banco específico que eles escolheram. O PayPal usa outros erros, como PAYER_ACCOUNT_LOCKED_OR_CLOSED, para problemas de conta.
Fontes
- Erros da API Orders v2 — PayPal
- Lidar com falhas de financiamento — PayPal
- Referência da API Orders v2 — PayPal
Relacionado
- TRANSACTION_REFUSED — Transação recusada: o PayPal recusou a solicitação sem um motivo específico.
- REDIRECT_PAYER_FOR_ALTERNATE_FUNDING — Redirecionar para financiamento alternativo: envie o comprador de volta para escolher outra fonte de financiamento.
- PAYER_CANNOT_PAY — Pagador não pode pagar: as configurações do PayPal deste comprador e deste vendedor não permitem o pagamento.
- 5100 — Recusa genérica: o cartão foi recusado e nenhuma razão foi dada.
- PAYER_ACTION_REQUIRED — Ação do pagador necessária: o comprador deve voltar ao PayPal para finalizar o pagamento.
- PAYEE_ACCOUNT_RESTRICTED — Conta do recebedor restrita: a conta PayPal do lojista está restrita.
- PAYER_ACCOUNT_LOCKED_OR_CLOSED — Conta do pagador bloqueada ou fechada: a conta PayPal do comprador não pode ser usada.
- COMPLIANCE_VIOLATION — Violação de conformidade: O PayPal recusou o pagamento por motivos de conformidade.