A iugu API utiliza os próprios códigos de status HTTP para indicar sucesso ou falha da chamada. Os códigos iniciados com 2 indicam sucesso, com 4 apontam algum erro e com 5 apresentam erro interno nos servidores da iugu.
Pode conter tanto uma string de erro como um hash contendo o atributo e seus erros.
Veja a seguir os erros mais comuns:
| Código | Status | Descrição |
| 200 | OK | O recurso solicitado foi processado e retornado com sucesso. |
| 400 | Bad Request | Não foi possível interpretar a requisição. Verifique a sintaxe das informações enviadas. |
| 401 | Unauthorized | A chave da API está desativada, incorreta ou não foi informada corretamente. |
| 404 | Not Found | O recurso solicitado ou o endpoint não foi encontrado. |
| 422 | Unprocessable Entity | A requisição foi recebida com sucesso, porém contém parâmetros inválidos. Para mais detalhes, verifique o atributo errors no corpo da resposta. |
| 429 | Too Many Requests | Requisição não foi realizada com sucesso, porque a API alcançou o limite de requisições que pode receber/tentar por minuto. |
| 500 | Internal Server Error | Indica uma dificuldade de processamento do servidor, a partir de uma incompatibilidade ou configuração incorreta em uma aplicação de um site. |
| 504 | Timeout | O servidor estava impossibilitado de completar sua solicitação. |
Veja os erros que são apresentados em inglês para o português:
| Inglês | Português |
| cant' be blank | não pode ficar em branco |
| can't be empty | não pode ficar vazio |
| must be greater tha N |
deve ser maior que N |
| must be greater than or equal to N | deve ser maior ou igual a N |
| is not included in the list | não está incuído na lista |
| is invalid | não é válido |
| must be less tha N | deve ser menor que N |
| must be less than or equal to N | deve ser menor ou igual a N |
| is not a number | não é um número |
| should not be in the pas | não pode estar no passado |
| Too many requests with invalid pix key. Try again in 60 seconds | Limite de requisições atingido com números inválidos de chave PIX. Tente novamente em 60 segundos |
1 Comentários