Códigos de recusa
Códigos de recusa do PayPal: o que cada um significa e o que fazer
Verificado em
O PayPal informa um pagamento falho de duas maneiras. Um pagamento com cartão carrega um código de resposta do processador, como 0500 DO_NOT_HONOR ou 5120 INSUFFICIENT_FUNDS, definido pelo banco ou processador. Qualquer pagamento do PayPal também pode falhar com um erro da API Orders, como INSTRUMENT_DECLINED ou PAYER_ACTION_REQUIRED. Cada página abaixo apresenta o próprio significado do PayPal, o que o comprador e a loja podem fazer, e o que a PlatformDTC faz com essa recusa.
| Código | Significado |
|---|---|
| 0100 | Encaminhamento: o banco do cartão quer que o titular do cartão o contate antes de aprovar. |
| 0390 | Conta não encontrada: o banco não tem uma conta que corresponda a esses detalhes do cartão. |
| 0500 | Não honrar: o banco do cartão recusou o pagamento e não deu nenhuma razão. |
| 0580 | Transação não autorizada: o pagamento não está autorizado para este cartão. |
| 0960 | Mau funcionamento do sistema: uma falha técnica interrompeu o pagamento, não uma recusa do banco. |
| 10BR | Emissor rejeitou: o banco do cartão recusou o pagamento. |
| 1310 | Valor inválido: o valor do pagamento foi recusado como inválido. |
| 1320 | Código de moeda inválido: a moeda do pagamento não pode ser usada aqui. |
| 1330 | Conta inválida: a conta do cartão não é válida para pagamentos. |
| 1380 | Expiração inválida: a data de validade enviada não corresponde a um cartão válido. |
| 1382 | Valor de verificação de cartão inválido: o código de segurança (CVV) foi rejeitado. |
| 5100 | Recusa genérica: o cartão foi recusado e nenhuma razão foi dada. |
| 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. |
| 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. |
| 5200 | Transação duplicada: um pagamento correspondente já foi enviado. |
| 5400 | Cartão expirado: o cartão está com a data de validade vencida. |
| 5650 | SCA exigido: o banco precisa que o titular do cartão autentique o pagamento. |
| 5700 | Transação não permitida: fora do escopo de negócios aceitos para este cartão. |
| 5710 | Tentativas excedem o limite: muitas tentativas de pagamento neste cartão. |
| 5910 | Emissor não disponível, não retentável: o banco não pôde ser contatado e o PayPal diz para não tentar novamente. |
| 5920 | Emissor não disponível, retentável: o banco não pôde ser contatado; tente novamente mais tarde. |
| 5930 | Cartão não ativado: o cartão ainda não foi ativado pelo titular. |
| 5950 | Conta atualizada: um cartão atualizado foi emitido, então os detalhes antigos foram recusados. |
| 6300 | Conta não encontrada: o banco não tem registro desta conta de cartão. |
| 7710 | Autenticação falhou: a verificação 3-D Secure não foi aprovada. |
| 8000 | Erro de sistema do processador: uma falha técnica no processador interrompeu o pagamento. |
| 9100 | Recusado, por favor, tente novamente: uma recusa temporária; o conselho do PayPal é tentar novamente. |
| 9500 | Fraude suspeita: o pagamento foi sinalizado; o PayPal diz para usar outro cartão. |
| 9510 | Violação de segurança: o pagamento quebrou uma regra de segurança e foi recusado. |
| 9520 | Perdido ou roubado: o cartão foi reportado como perdido ou roubado; o PayPal diz para usar outro cartão. |
| 9530 | Retenção, central de atendimento: o lojista deve ligar para o número no verso do cartão. |
| 9540 | Cartão recusado: o cartão foi recusado para este pagamento. |
| 00N7 | Falha de CVV2, tentar novamente com CVV: o código de segurança falhou; tente novamente com o correto. |
| PCVV | Falha de CVV: a verificação do código de segurança do cartão falhou. |
| PP06 | Conta encerrada: uma conta anteriormente aberta agora está encerrada. |
| PPRN | Nova tentativa não permitida: outra tentativa neste pagamento não é permitida. |
| PPAB | Conta bloqueada pelo emissor: o banco do cartão bloqueou a conta. |
| PPAD | Endereço de cobrança: o pagamento foi recusado devido ao endereço de cobrança. |
| 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. |
| PPEX | Data de validade: o pagamento foi recusado devido à data de validade do cartão. |
| PPFR | Instrumento de financiamento restrito: o cartão ou conta tem uma restrição. |
| INSTRUMENT_DECLINED | Instrumento recusado: o cartão ou banco no PayPal do comprador foi recusado. |
| PAYER_ACTION_REQUIRED | Ação do pagador necessária: o comprador deve voltar ao PayPal para finalizar o pagamento. |
| PAYER_CANNOT_PAY | Pagador não pode pagar: as configurações do PayPal deste comprador e deste vendedor não permitem o pagamento. |
| TRANSACTION_REFUSED | Transação recusada: o PayPal recusou a solicitação sem um motivo específico. |
| 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. |
| MAX_NUMBER_OF_PAYMENT_ATTEMPTS_EXCEEDED | Número máximo de tentativas de pagamento excedido: muitas tentativas para este pedido. |
| CARD_EXPIRED | Cartão expirado: o cartão usado via PayPal expirou. |
| CARD_TYPE_NOT_SUPPORTED | Tipo de cartão não suportado: este tipo de cartão não pode ser processado; use outro. |
| AGREEMENT_ALREADY_CANCELLED | Acordo já cancelado: o acordo de faturamento do PayPal do comprador foi cancelado. |
| REDIRECT_PAYER_FOR_ALTERNATE_FUNDING | Redirecionar para financiamento alternativo: envie o comprador de volta para escolher outra fonte de financiamento. |
| TRANSACTION_BLOCKED_BY_PAYEE | Bloqueado pelo beneficiário: as próprias configurações de fraude do PayPal do lojista bloquearam o pagamento. |
| PAYEE_BLOCKED_TRANSACTION | Transação bloqueada pelo beneficiário: a ferramenta de fraude do PayPal do lojista a recusou. |
| TRANSACTION_LIMIT_EXCEEDED | Limite de transação excedido: o total está acima de um limite de transação do PayPal. |
| PAYMENT_DENIED | Pagamento negado: o PayPal recusou processar a transação. |
Códigos de resposta do processador e erros da API Orders
Códigos de resposta do processador são valores de quatro caracteres que o PayPal retorna em uma captura ou autorização de cartão recusada, em `processor_response.response_code`. Eles vêm do banco do cartão ou do processador e são o mais próximo que o PayPal oferece de um motivo de recusa bancária. O PayPal publica cada código com um nome curto (por exemplo, 9500 SUSPECTED_FRAUD) e, para alguns, uma instrução como "Tente usar outro cartão. Não tente novamente com o mesmo cartão."
Erros da API Orders são os nomes de problemas que o PayPal retorna quando uma solicitação falha, por exemplo INSTRUMENT_DECLINED quando a fonte de financiamento do comprador é recusada, ou PAYER_ACTION_REQUIRED quando o comprador precisa retornar ao PayPal. Eles se aplicam tanto a pagamentos com carteira PayPal quanto a pagamentos com cartão.
Pagamentos com cartão PayPal e pagamentos com carteira PayPal
Quando um comprador digita um cartão nos campos de cartão do PayPal, a recusa geralmente vem com um código de resposta do processador do banco do cartão, então o motivo pode ser tão específico quanto um cartão expirado ou um código de segurança falho.
Quando um comprador paga com sua carteira PayPal, o PayPal escolhe a fonte de financiamento dentro da carteira e geralmente informa uma falha como um erro da API Orders, como INSTRUMENT_DECLINED. A orientação do PayPal para esse caso é reiniciar o pagamento para que o comprador possa escolher outra fonte de financiamento.
O que a PlatformDTC faz com as recusas do PayPal
A PlatformDTC transforma cada código de processador de cartão PayPal que reconhece em um tipo de recusa simples (fundos insuficientes, cartão expirado, recusa bancária sem motivo, erro temporário, autenticação necessária ou um cartão inativo) e mantém o código bruto na mensagem de falha para suporte.
Com a Retentativa inteligente ativada, as renovações de assinatura do PayPal que falham por falta de fundos ou com uma recusa genérica do PayPal recebem uma escada de retentativas mais longa do que os cartões: até 7 tentativas, cada uma com pelo menos 3 dias de intervalo da última, movidas para o próximo dia de pagamento do assinante quando uma cair dentro de uma semana, dentro de uma janela de pelo menos 24 dias. Acordos inativos e contas PayPal fechadas ou bloqueadas nunca são retentados: a assinatura é cancelada imediatamente, independentemente da configuração. Recusas definitivas (cartões inativos, expirados ou restritos, PAYER_CANNOT_PAY) não são retentadas em nenhum dos agendamentos, incluindo o padrão Fixo: a assinatura é mantida em atraso e o cliente é solicitado a fornecer um novo método de pagamento. Recusas causadas pela própria conta PayPal da loja (PAYEE_ACCOUNT_RESTRICTED, PAYEE_BLOCKED_TRANSACTION) nunca são atribuídas ao cliente: a renovação é pausada, retentada automaticamente e o comerciante recebe um alerta no painel.
Perguntas frequentes
- Onde encontro o código de recusa do PayPal para um pedido?
- Para pagamentos com cartão, no `processor_response.response_code` da captura ou autorização. Para qualquer pagamento do PayPal, o corpo do erro da solicitação falha nomeia o problema, como INSTRUMENT_DECLINED, em `details[0].issue`.
- Quais códigos de recusa do PayPal nunca devem ser retentados?
- O próprio PayPal diz para não retentar o mesmo cartão para 5150, 5180, 9500 e 9520. Cartões expirados, fechados ou inválidos, códigos de segurança falhos e acordos de faturamento cancelados também não terão sucesso em uma retentativa.
- Por que o PayPal diz INSTRUMENT_DECLINED sem um motivo?
- O erro cobre qualquer recusa da fonte de financiamento escolhida pelo comprador pelo processador ou banco. O conselho do PayPal é reiniciar o pagamento para que o comprador possa escolher outra fonte.
- A PlatformDTC retenta pagamentos de assinatura do PayPal?
- Sim, para recusas que podem ser recuperadas. Com a Retentativa inteligente ativada, fundos e recusas genéricas recebem até 7 tentativas ao longo de pelo menos 24 dias, erros temporários até 4, e recusas bancárias sem motivo uma; no agendamento Fixo padrão, eles são retentados com 1, 3, 5 e 7 dias de intervalo. Cartões inativos, cartões expirados e contas fechadas não são retentados em nenhum dos agendamentos.