Skip to main content

Códigos HTTP

HTTPSignificadoAção
400Dados inválidosCorrija os campos antes de reenviar.
401Chave inválidaConfira o header X-API-Key e a situação da credencial.
403Acesso bloqueadoRevise escopo, permissões, IPs e bloqueios da conta.
404Recurso não encontradoConfira o ID e a carteira à qual ele pertence.
409ConflitoNão reutilize uma chave de idempotência com outro corpo.
422Regra da operaçãoConfira saldo disponível, limites e dados obrigatórios.
429Limite de chamadasAguarde antes de continuar.
503Provedor indisponívelConsulte a operação antes de repetir uma escrita.

Repetição segura

Para a mesma operação, repita a mesma chave e os mesmos dados. Uma resposta em processamento não autoriza criar outra operação com uma chave diferente.

Exemplo de erro

{
  "success": false,
  "message": "Saldo disponível insuficiente.",
  "error": {
    "code": "INSUFFICIENT_BALANCE",
    "statusCode": 422
  },
  "requestId": "req_exemplo"
}

Pesquisar documentação