Skip to main content
Toda resposta de erro tem o mesmo formato: success: false, um objeto error e um requestId. Decida pelo error.code, que é estável. A error.message é para humanos e pode mudar.
Registre o requestId de toda resposta nos seus logs, não só nas de erro. É o que o suporte pede para localizar a requisição.

Por status HTTP

Catálogo de error.code

Autenticação e conta

Requisição

Idempotência

Operação financeira

Split

Limites

Em produção, erros 5xx trazem uma mensagem genérica (“Não foi possível processar a solicitação.”). Quem diagnostica é o requestId, com o suporte.

429: limite de requisições

A NyxPag aplica 100 requisições por janela de 60 segundos, por API Key, somando todas as rotas e o MCP. Proteções adicionais por IP também podem devolver 429.
Veja Limites para as regras completas da cota.

O que repetir e o que não repetir

Ao repetir POST /transactions ou POST /transfers, use a mesma Idempotency-Key ou externalId. Uma chave nova cria uma operação nova. Veja Idempotência.

Repetição com backoff e jitter

Idempotência

Repetição segura nas operações financeiras.

Troubleshooting

Sintomas comuns e como resolver.