---
title: Erros
description: Códigos de status, códigos de erro e o que fazer em cada caso.
sidebar:
  order: 6
---
Todos os erros têm o mesmo formato:

```json
{
  "error": {
    "type": "invalid_request_error",
    "code": "validation_error",
    "message": "`kg` is invalid: Too small: expected number to be >=1.",
    "param": "kg"
  }
}
```

`param` indica o campo da requisição que causou o erro, quando houver um. Toda resposta tem um cabeçalho `Request-Id`. Informe esse valor ao entrar em contato com o suporte.

| Status | Código | Tentar de novo? | O que fazer |
| --- | --- | --- | --- |
| 400 | `invalid_json` | Não | Envie um objeto JSON de no máximo 10 KB. |
| 400 | `idempotency_key_missing` / `idempotency_key_invalid` | Não | Envie uma [Idempotency-Key](/docs/pt/idempotency) válida. |
| 401 | `invalid_api_key` | Não | Verifique a chave. Ela pode ter sido revogada. |
| 402 | `insufficient_balance` | Após uma recarga | O erro inclui `balance_cents` e `required_cents`. |
| 403 | `api_access_inactive` | Não | A conta não foi aprovada ou está suspensa. Entre em contato com o suporte. |
| 403 | `insufficient_permissions` | Não | Use uma chave com acesso de compra. |
| 404 | `resource_missing` / `not_found` | Não | Verifique o ID da compensação ou o caminho. |
| 409 | `idempotency_key_reused` | Não | Use uma nova chave para cada nova compra. |
| 422 | `validation_error` | Não | Corrija o campo indicado em `param`. |
| 422 | `amount_too_small` | Não | Com a sua tarifa, o valor compra menos de 1 kg. |
| 429 | `rate_limited` | Sim | Aguarde o número de segundos indicado em `Retry-After`. |
| 500 | `api_error` | Sim | Tente de novo com a mesma Idempotency-Key. |