---
title: Errores
description: Códigos de estado, códigos de error y qué hacer en cada caso.
sidebar:
  order: 6
---
Todos los errores tienen la misma estructura:

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

`param` indica el campo de la solicitud que causó el error, si lo hay. Cada respuesta incluye un encabezado `Request-Id`: indíquelo cuando se comunique con el equipo de soporte.

| Estado | Código | ¿Reintentar? | Qué hacer |
| --- | --- | --- | --- |
| 400 | `invalid_json` | No | Envíe un objeto JSON de 10 KB como máximo. |
| 400 | `idempotency_key_missing` / `idempotency_key_invalid` | No | Envíe un encabezado [Idempotency-Key](/docs/es/idempotency) válido. |
| 401 | `invalid_api_key` | No | Revise la clave; es posible que se haya revocado. |
| 402 | `insufficient_balance` | Después de una recarga | El error incluye `balance_cents` y `required_cents`. |
| 403 | `api_access_inactive` | No | La cuenta no está aprobada o está suspendida. Comuníquese con el equipo de soporte. |
| 403 | `insufficient_permissions` | No | Use una clave con acceso de compra. |
| 404 | `resource_missing` / `not_found` | No | Revise el ID de la compensación o la ruta. |
| 409 | `idempotency_key_reused` | No | Use una clave nueva para una compra nueva. |
| 422 | `validation_error` | No | Corrija el campo indicado en `param`. |
| 422 | `amount_too_small` | No | Con su tarifa, el monto equivale a menos de 1 kg. |
| 429 | `rate_limited` | Sí | Espere los segundos que indica `Retry-After`. |
| 500 | `api_error` | Sí | Vuelva a intentarlo con el mismo Idempotency-Key. |