PayZu GatewaySegurança

Limites de requisição


Saiba quanto esperar antes de repetir uma chamada recusada por excesso de requisições e em quais rotas as chamadas são contadas por IP.

Onde vale

O limite vale para a geração de token de cartão e para as rotas do Checkout, contado pelo IP de origem da chamada:

RotasLimite por IP
POST /v1/card-tokens10 chamadas por minuto
POST /v1/checkout/subscriptions10 chamadas por minuto
POST /v1/checkout/invoices/:invoice_id/payments
POST /v1/checkout/payment-links/:payment_link_id/invoices
10 chamadas por minuto, somadas as duas rotas
GET /v1/checkout/plans/:plan_id
GET /v1/checkout/subscriptions/:subscription_id
GET /v1/checkout/payment-links/:payment_link_id
GET /v1/checkout/invoices/:invoice_id
60 chamadas por minuto, somadas as consultas

Cada linha da tabela tem o próprio contador. A contagem começa na primeira chamada e zera 60 segundos depois.

Gere o token de cartão no aparelho do comprador.

O IP contado é o de quem chama, então as chamadas que saem do seu servidor somam todas no IP dele.

Como ler o 429

A chamada acima do limite recebe 429, sem code e sem tempo de espera:

json
{
  "status_code": 429,
  "error": "too_many_requests",
  "message": "Muitas tentativas. Aguarde um minuto.",
  "request_id": "a1b2c3d4-0000-4000-8000-000000000000"
}

Espere um minuto e só então repita a chamada. A chamada recusada com 429 não chega a ser processada, então a repetição não cria assinatura, fatura nem tentativa de pagamento em dobro.