Rate limiting - ZeriqPay Docs

A API aplica limites por conta e por operação para proteger a estabilidade dos provedores e evitar duplicidade de solicitações.

Limite geral

As rotas autenticadas passam pelo UserRateLimitGuard. O limite específico varia por operação. Quando excedido, a API retorna HTTP 429.

Limites específicos

Operação	Limite	Janela	Rotas
Consultar pagamento	8	60 s	`GET /v1/payments/check`, `GET /v1/payments/check/{id}`
Consultar disputa MED	10	60 s	`GET /v1/infraction/get/{id}`, `POST /v1/infraction/check`
Criar reembolso	3	300 s	`POST /v1/refunds/create`
Consultar reembolso	8	60 s	`GET /v1/refunds/{refundId}`
Enviar evidência MED	4	300 s	`POST /v1/infraction/evidence/{id}`

As rotas sem uma regra específica continuam protegidas pelo limitador por usuário configurado no backend.

Boas práticas

Use uma chave de idempotência no seu próprio sistema para evitar repetir cobranças e transferências após timeouts. Para consultas, prefira paginação e implemente backoff exponencial ao receber 429.

{
  "success": false,
  "statusCode": 429,
  "message": "Too many requests"
}