PayPal · Códigos de recusa
O que significa o código de resposta do processador PayPal 5200?
Verificado em
O código de resposta do processador PayPal 5200 (DUPLICATE_TRANSACTION) significa que o pagamento foi recusado como uma duplicata de um já enviado. Antes de fazer qualquer outra coisa, o lojista deve verificar se o primeiro pagamento foi processado, para que o cliente não seja cobrado duas vezes. Se não foi, uma nova e única tentativa está ok; o comprador não deve continuar pressionando pagar.
- Etiqueta PayPal
- DUPLICATE_TRANSACTION
- Tipo
- Não é uma recusa do banco
- Quem recusou
- PayPal ou a rede de pagamento
- Tentar novamente
- Sim, alguns dias depois; mude o método se repetir
- Ação do comprador
- Não pague novamente até que a loja confirme
- Ação do lojista
- Verifique se há um pagamento existente antes de tentar novamente
- 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
O PayPal 5200 não é um dos códigos de processador que a PlatformDTC mapeia, então a recusa é registrada sob o problema da API Orders que o PayPal retornou, ou como INSTRUMENT_DECLINED, uma recusa genérica do PayPal, quando não há nenhuma; o 5200 bruto permanece na mensagem de falha. Com o Smart retry ativado, a renovação de uma assinatura PayPal segue então 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
Os mesmos detalhes de pagamento chegaram duas vezes em pouco tempo: um clique duplo, uma atualização de página ou uma nova tentativa automática que foi acionada muito cedo.
O que o comprador pode fazer
Espere e verifique a confirmação do seu pedido ou e-mail; o primeiro pagamento pode ter sido bem-sucedido.
O que a loja pode fazer
Procure o pedido no PayPal antes de tentar novamente.
Certifique-se de que um clique duplo ou uma atualização de página não possa enviar o mesmo pagamento duas vezes.
Para desenvolvedores
O PayPal retorna 5200 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 é DUPLICATE_TRANSACTION.
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
- O cliente foi cobrado duas vezes?
- 5200 significa que a segunda tentativa foi recusada, o que protege contra uma cobrança dupla. Verifique se a primeira foi concluída.
- Como evito erros de transação duplicada?
- Desative o botão de pagamento após o primeiro clique e certifique-se de que cada checkout envie sua solicitação de pagamento apenas uma vez.
Fontes
Relacionado
- 1310 — Valor inválido: o valor do pagamento foi recusado como inválido.
- 9100 — Recusado, por favor, tente novamente: uma recusa temporária; o conselho do PayPal é tentar novamente.
- 0960 — Mau funcionamento do sistema: uma falha técnica interrompeu o pagamento, não uma recusa do banco.
- 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.