PayPal · Códigos de recusa
O que significa o erro PayPal TRANSACTION_REFUSED?
Verificado em
O erro TRANSACTION_REFUSED do PayPal significa que o PayPal recusou a solicitação de pagamento; sua descrição é simplesmente "A solicitação foi recusada." Nenhum motivo é dado, e a recusa pode ser temporária. O comprador pode tentar novamente mais tarde ou escolher outra fonte de financiamento, e o lojista deve espaçar as novas tentativas em vez de tratá-la como permanente.
- Descrição do PayPal
- A solicitação foi recusada.
- Tipo
- Recusa temporária
- Quem recusou
- PayPal
- Nova tentativa
- Sim, alguns dias depois; mude o método se repetir
- Ação do comprador
- Tentar novamente mais tarde ou usar outro método
- Ação do lojista
- Tentar novamente mais tarde, espaçado; oferecer outro método
- Renovação PlatformDTC (Smart retry)
- Sequência PayPal: até 7 tentativas, com 3+ dias de intervalo, visando o dia de pagamento
O que a PlatformDTC faz
PlatformDTC trata TRANSACTION_REFUSED como uma recusa genérica que pode ser retentada e deliberadamente a deixa fora de sua lista de interrupção padrão, porque pode ser temporária. Com a Retentativa Inteligente ativada, uma renovação de assinatura do PayPal recusada desta forma segue a escada do PayPal: até 7 tentativas, cada uma pelo menos 3 dias após a ú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. A assinatura é mantida em atraso, não cancelada, se todas as tentativas falharem.
Por que acontece
A descrição do PayPal não dá nenhuma razão. Pode refletir as próprias verificações de risco do PayPal ou uma condição temporária.
O que o comprador pode fazer
Espere um pouco e tente novamente, ou pague com um cartão ou outro método.
O que a loja pode fazer
Não trate como final na primeira tentativa; retente ao longo dos dias para assinaturas.
Ofereça outro método de pagamento no checkout.
Para desenvolvedores
Na API Orders v2, o problema aparece em details[0].issue do corpo do erro.
Perguntas frequentes
- TRANSACTION_REFUSED é permanente?
- Não necessariamente. O PayPal não dá nenhuma razão, e a PlatformDTC o mantém retentável porque pode ser resolvido.
- Qual a diferença de INSTRUMENT_DECLINED?
- INSTRUMENT_DECLINED aponta para a fonte de financiamento; TRANSACTION_REFUSED é uma recusa da solicitação sem detalhes.
Fontes
- Erros da API Orders v2 — PayPal
Relacionado
- INSTRUMENT_DECLINED — Instrumento recusado: o cartão ou banco no PayPal do comprador foi recusado.
- PAYMENT_DENIED — Pagamento negado: o PayPal recusou processar a transação.
- PAYEE_BLOCKED_TRANSACTION — Transação bloqueada pelo beneficiário: a ferramenta de fraude do PayPal do lojista a recusou.
- 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.