PayPal · Códigos de recusa
O que significa o erro PayPal PAYER_ACTION_REQUIRED?
Verificado em
O erro PAYER_ACTION_REQUIRED do PayPal significa que o pagamento não pode ser concluído até que o comprador realize uma ação; a instrução do PayPal é "instruir o comprador a retornar ao PayPal." Reenviar sem o comprador falhará novamente, então envie-o de volta ao PayPal. Em uma assinatura PayPal salva, o comprador não está presente, então a loja precisa trazê-lo de volta.
- Descrição do PayPal
- A transação não pode ser concluída com sucesso, instrua o comprador a retornar ao PayPal.
- Tipo
- Ação do comprador necessária
- Quem recusou
- PayPal
- Tentar novamente
- Somente depois que o comprador concluir a etapa no PayPal
- Ação do comprador
- Retorne ao PayPal e conclua a etapa mostrada
- Ação do lojista
- Envie o comprador de volta ao PayPal; não reenvie cegamente
- Renovação PlatformDTC
- Sem nova tentativa cega; cliente solicitado a confirmar com seu banco
O que a PlatformDTC faz
A PlatformDTC trata PAYER_ACTION_REQUIRED como um pagamento que precisa do cliente. Em qualquer agendamento de nova tentativa (o agendamento padrão Fixo ou Smart retry), uma renovação recusada desta forma nunca é tentada novamente cegamente, porque ninguém está lá para responder: a assinatura é mantida em atraso e o cliente recebe um e-mail pedindo para confirmar o pagamento, além de um link de um clique assinado para corrigir, reenviado até 4 vezes por ciclo de faturamento.
Por que acontece
O PayPal precisa de algo do comprador antes de poder finalizar: uma aprovação ou uma etapa de verificação.
O que o comprador pode fazer
Abra o PayPal novamente do checkout ou do e-mail que você recebeu e finalize a etapa que ele mostra.
O que a loja pode fazer
Redirecione o comprador para o link de aprovação do PayPal em vez de tentar novamente.
Para assinaturas, envie um e-mail ao cliente: somente ele pode completar a etapa.
Para desenvolvedores
O problema aparece em details[0].issue. Em Orders v2, um pedido ou token de configuração de cofre também pode ficar no status PAYER_ACTION_REQUIRED com um link de ação do pagador em seu array de links; envie o comprador para lá e capture depois que ele retornar.
Perguntas frequentes
- Por que uma renovação não pode completar PAYER_ACTION_REQUIRED por conta própria?
- Porque a ação pertence ao comprador. Tentar novamente sem ele retorna o mesmo erro.
- PAYER_ACTION_REQUIRED é uma recusa?
- Não é uma recusa de fundos; é uma pausa até que o comprador aja.
Fontes
- Erros da API Orders v2 — PayPal
- Referência da API Orders v2 — PayPal
Relacionado
- INSTRUMENT_DECLINED — Instrumento recusado: o cartão ou banco no PayPal do comprador foi recusado.
- PAYER_CANNOT_PAY — Pagador não pode pagar: as configurações do PayPal deste comprador e deste vendedor não permitem o pagamento.
- 5650 — SCA exigido: o banco precisa que o titular do cartão autentique 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.