Limites e erros

Limite de requisições

100 requisições por minuto por credencial, somando todas as rotas da v1 e da API legada.

• A contagem é pela chave pública (x-public-key). Duas credenciais no mesmo servidor têm limites separados; um IP compartilhado não mistura clientes.
• A consulta de transação e a de assinatura da API legada têm um teto próprio, mais baixo: 30 por minuto.
• Toda resposta traz X-RateLimit-Limit, X-RateLimit-Remaining e X-RateLimit-Reset (segundos até o limite renovar).
• Acima do limite, a resposta é 429 com Retry-After (segundos).

Não faça polling. Para saber quando uma venda foi paga, use webhooks.

Erros da v1

{ "statusCode": 404, "message": "Venda não encontrada.", "error": "Not Found" }

Status	Quando
400	parâmetro inválido (por exemplo page=abc ou page=0; page_size acima de 100 é limitado a 100)
401	credencial ausente, inválida, revogada ou expirada (mesma mensagem nos quatro casos)
403	a credencial não tem a permissão da rota
404	não existe, ou não é da sua conta
429	limite de requisições (veja acima)
503	manutenção programada, com Retry-After
5xx	falha nossa. Tente de novo com espera progressiva.

A API legada tem o formato de erro da plataforma anterior: veja API legada.