Códigos de erro
A API retorna um código alfanumérico no corpo da resposta de erro, junto com o HTTP status. Use esta tabela para mapear erros e exibir mensagens adequadas ao usuário ou para lógica de retry.
Tabela de códigos
| Código | HTTP Status | Descrição |
|---|---|---|
| INVALID_API_KEY | 401 | Chave de API inválida, expirada ou ausente |
| INSUFFICIENT_PERMISSIONS | 403 | API Key sem permissão para o recurso solicitado |
| RATE_LIMIT_EXCEEDED | 429 | Limite de requisições por minuto excedido |
| INVALID_REQUEST | 400 | Payload ou parâmetros inválidos |
| RESOURCE_NOT_FOUND | 404 | Recurso não encontrado (ex.: transação ou PIX inexistente) |
| PAYLOAD_TOO_LARGE | 413 | Corpo da requisição excede o tamanho máximo permitido |
| INVALID_CONTENT_TYPE | 400 | Content-Type não suportado (esperado application/json) |
| INTERNAL_ERROR | 500 | Erro interno do servidor; pode ser retentado |