PayPal · Códigos de recusa
O que significa o código de resposta do processador PayPal PPAD?
Verificado em
O código de resposta do processador PayPal PPAD (`BILLING_ADDRESS`) significa que o pagamento foi recusado por causa do endereço de cobrança. O rótulo do PayPal não diz mais. O comprador deve inserir o endereço de cobrança exatamente como aparece no extrato do cartão, ou usar outro cartão.
- Rótulo do PayPal
- `BILLING_ADDRESS`
- Tipo
- Erro de dados
- Quem recusou
- PayPal ou o banco do cartão
- Tentar novamente
- Sim, alguns dias depois; mude o método se repetir
- Ação do comprador
- Reinsira o endereço de cobrança do extrato do cartão
- Ação do lojista
- Deixe o comprador corrigir o endereço
- 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
PayPal PPAD não é um dos códigos de processador que a PlatformDTC mapeia, então a recusa é registrada sob o problema da Orders API que o PayPal retornou, ou como `INSTRUMENT_DECLINED`, uma recusa genérica do PayPal, quando não há nenhum; o PPAD bruto permanece na mensagem de falha. Com o Smart retry ativado, uma renovação de assinatura do PayPal segue a escada PayPal: até 7 tentativas com pelo menos 3 dias de intervalo, movidas para o próximo dia de pagamento dentro de uma semana, dentro de uma janela de pelo menos 24 dias.
Por que acontece
O endereço de cobrança causou a recusa.
O que o comprador pode fazer
Insira o endereço de cobrança que seu banco tem registrado, incluindo o CEP.
O que a loja pode fazer
Torne o endereço de cobrança editável na tela de recusa.
Verifique se seu checkout passa todos os campos de endereço para o PayPal.
Para desenvolvedores
O PayPal retorna PPAD 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 é `BILLING_ADDRESS`.
O mesmo objeto `processor_response` também contém `avs_code`, o resultado da verificação de endereço, que vale a pena armazenar junto com o pedido.
Perguntas frequentes
- PPAD é o mesmo que 5170 AVS_FAILURE?
- Ambos se referem ao endereço de cobrança. O PayPal os lista como códigos separados; a solução é a mesma.
- Posso tentar novamente PPAD com o mesmo endereço?
- Provavelmente falhará novamente. Corrija o endereço primeiro.
Fontes
Relacionado
- 5170 — Falha AVS: o endereço de cobrança não correspondeu aos registros do banco.
- 5110 — Falha de CVV2: o código de segurança do cartão não correspondeu.
- 1330 — Conta inválida: a conta do cartão não é válida para pagamentos.
- PPAX — Valor excedido: o pagamento está acima de um limite no cartão ou conta.
- PPCT — Tipo de cartão não suportado: este tipo de cartão não é aceito para o pagamento.
- PPD3 — Erro 3-D Secure: a etapa de autenticação do cartão teve um erro.
- PPEF — Instrumento de pagamento expirado: o cartão ou conta usado para pagar expirou.
- PPEL — Excede limite de frequência: muitos pagamentos em um período neste cartão.