Começando

Rate limits

Para garantir estabilidade a todos os clientes, a API limita a quantidade de requisições em janelas de 1 minuto.

Escopo	Limite	Janela
Endpoints autenticados (por credencial)	120 requisições	1 minuto
Emissão de token `POST /auth/token` (por IP)	30 requisições	1 minuto

Ao exceder o limite

A API retorna 429 rate_limited com o header Retry-After (em segundos). Aguarde alguns segundos e tente novamente usando backoff exponencial (ex.: 1s, 2s, 4s...). A janela é reiniciada 60 segundos após a primeira requisição dela.

Boas práticas

Reutilize o access token durante toda a sua validade (1 hora) em vez de emitir um novo a cada chamada.
Prefira webhooks a fazer polling de status de transações.
Use GET /transactions com limit=100 e filtros de data para conciliações em lote.
Se precisar de um limite maior, fale com o suporte.

Resposta

{
  "error": {
    "code": "rate_limited",
    "message": "Limite de requisições excedido. Tente novamente em instantes."
  }
}