error, que não muda entre versões. O message é só para leitura humana. Nos SDKs, o erro vira uma exceção ClarianError com status e code.
Códigos comuns
A referência de cada rota lista os códigos que ela pode devolver.
Documentation Index
Fetch the complete documentation index at: /llms.txt
Use this file to discover all available pages before exploring further.
Todo erro tem o mesmo formato e um código estável.
{ "error": "quote_expired", "message": "opcional, só em alguns erros" }
error, que não muda entre versões. O message é só para leitura humana. Nos SDKs, o erro vira uma exceção ClarianError com status e code.
| HTTP | error | O que fazer |
|---|---|---|
| 401 | unauthorized | Confira a chave e o prefixo do ambiente. |
| 403 | ip_not_allowed | Cadastre o IP do servidor na chave de produção. |
| 403 | settlement_key_required | Cadastre a chave PIX de liquidação no painel. |
| 403 | destination_not_whitelisted | Aprove o endereço na lista de saque do painel. |
| 409 | idempotency_key_reuse | A mesma chave de idempotência veio com outro corpo. |
| 409 | quote_not_open | A cotação já foi usada. Cote de novo. |
| 410 | quote_expired | A cotação venceu. Cote de novo. |
| 402 | insufficient_funds | Saldo available menor que valor mais taxa. |
| 429 | rate_limited | Espere a janela de um minuto. |