> ## Documentation Index
> Fetch the complete documentation index at: https://docs.zeriqpay.com.br/llms.txt
> Use this file to discover all available pages before exploring further.

# Rate limiting

> Limites gerais e específicos das rotas da API v1

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`.

```json theme={null}
{
  "success": false,
  "statusCode": 429,
  "message": "Too many requests"
}
```


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.