PayPal · Códigos de recusa
O que significa o código de resposta do processador PayPal PPEL?
Verificado em
O código de resposta do processador PayPal PPEL (`EXCEEDS_FREQUENCY_LIMIT`) significa que o cartão excedeu um limite de frequência de uso dentro de um período, então este pagamento foi recusado. O cartão não está bloqueado; o limite é redefinido com o tempo. O cliente pode esperar ou usar outro cartão, e os lojistas devem tentar novamente mais tarde, em vez de imediatamente.
- Rótulo do PayPal
- `EXCEEDS_FREQUENCY_LIMIT`
- Tipo
- Recusa temporária
- Quem recusou
- O banco do cartão ou PayPal
- Código Visa similar
- 65 (Exceeds withdrawal frequency limit): Visa Category 2: reattempts allowed, up to 20 in 30 days
- Tentar novamente
- Sim, mais tarde; geralmente se resolve com o tempo
- Ação do cliente
- Espere, ou use outro cartão
- Ação do lojista
- Tente novamente mais tarde, espaçadamente
- Renovação PlatformDTC (Smart retry)
- Tentado novamente 2, 5 e 8 dias depois, 4 tentativas no máximo
O que a PlatformDTC faz
Em um pagamento com cartão PayPal, PPEL se torna `withdrawal_count_limit_exceeded` no PlatformDTC, que o considera algo que se resolve com o tempo. Com o Smart retry ativado, as renovações seguem a escada curta: 2, 5 e 8 dias após a primeira recusa, 4 tentativas no máximo, então a assinatura aguarda em atraso pelo cliente.
Por que acontece
Um limite de frequência de uso foi atingido: muitos pagamentos em pouco tempo no mesmo cartão.
O que o cliente pode fazer
Espere até o limite ser redefinido, ou pague com um cartão diferente.
O que a loja pode fazer
Não tente novamente imediatamente; espace as tentativas ao longo dos dias.
Vários pedidos de um cartão em rápida sucessão podem acioná-lo.
Para desenvolvedores
O PayPal retorna PPEL em processor_response.response_code na captura (purchase_units[].payments.captures[]) ou autorização de um pagamento com cartão. O nome do próprio PayPal para isso é EXCEEDS_FREQUENCY_LIMIT.
A Visa tem um código de resposta bruto com nome semelhante, 65 ("Excede o limite de frequência de saque"); nas Regras Essenciais da Visa (24 October 2026, Table 7-2) esse código é da categoria 2: tentativas permitidas, até 20 em 30 dias. A lista de códigos do PayPal não mapeia seus códigos para os da Visa, então trate isso como contexto, não como uma tradução.
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
- Quanto tempo até PPEL ser liberado?
- O PayPal não publica o período. Uma nova tentativa alguns dias depois é um padrão sensato.
- PPEL é diferente de PPNL?
- O PayPal tem um código separado, PPNL EXCEEDS_NETWORK_FREQUENCY_LIMIT, para o limite da rede; a PlatformDTC lida com ambos da mesma forma.
Fontes
Relacionado
- 5710 — Tentativas excedem o limite: muitas tentativas de pagamento neste cartão.
- PPAX — Valor excedido: o pagamento está acima de um limite no cartão ou conta.
- 5120 — Fundos insuficientes: o cartão não tem dinheiro ou crédito suficiente para este pagamento.
- 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.