Erros

Quando uma requisição falha, a API responde com o código HTTP correspondente e um corpo JSON padronizado.

Formato do erro

{
  "error": "Bad Request",
  "message": "Descrição do que deu errado",
  "status_code": 400
}

Prop

Type

Status	Significado	Quando ocorre
`400`	Bad Request	Parâmetros inválidos ou ausentes (falha de validação)
`401`	Unauthorized	Token ausente, malformado ou inválido
`404`	Not Found	Recurso não encontrado (ex.: `pix_id` inexistente)
`500`	Internal Server Error	Erro inesperado no servidor

Os endpoints de cada recurso listam os códigos específicos que podem retornar. Consulte a página do endpoint para detalhes.

Requisições com corpo ou parâmetros inválidos retornam 400 com error: "Bad Request" e uma message descrevendo o campo que falhou:

{
  "error": "Bad Request",
  "message": "An instance of CreatePaymentRequest has failed the following validations: ...",
  "status_code": 400
}

Requisições sem um token válido retornam 401:

{
  "error": "Unauthorized",
  "message": "Não autenticado",
  "status_code": 401
}

Revise o cabeçalho Authorization conforme a página de Autenticação.