> ## Documentation Index
> Fetch the complete documentation index at: https://docs.vitawallet.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Códigos de error

> Formato de errores y referencia completa de códigos.

La API siempre responde con HTTP `422 UNPROCESSABLE ENTITY` cuando no puede procesar la petición. El código específico y el detalle del error vienen en el body:

```json theme={null}
{
  "code": 500,
  "message": "An error has occurred, please try again later"
}
```

## Rangos de códigos

| Rango | Significado |
| - | - |
| `3xx` | Validación de sintaxis y existencia de parámetros |
| `4xx` | Existencia de recursos |
| `5xx` | Lógica de negocio y errores de servidor |

## Validación de sintaxis y parámetros (3xx)

| Código | Descripción |
| - | - |
| `300` | Invalid `[header]` header, `[description]` |
| `301` | `[header]` header was not found |
| `302` | Signature version was not found |
| `303` | Invalid signature |
| `304` | Parameter `[parameter]` not found |
| `305` | Invalid `[parameter]`, `[description]` |

## Existencia de recursos (4xx)

| Código | Descripción |
| - | - |
| `404` | `[resource]` was not found |

## Lógica de negocio y servidor (5xx)

| Código | Descripción |
| - | - |
| `500` | An error has occurred, please try again later |
| `501` | Invalid IP address |
| `502` | Business `[parameter]` is not supported |
| `503` | `[parameter]` is used |
| `507` | Invalid amount, minimum amount of X CLP |
| `509` | Insufficient balance business |
| `510` | Insufficient balance wallet |
| `578` | Invalid `bank_code`, bank does not belong to the selected country |
| `579` | Invalid `account_bank`, incorrect account size |

> [!TIP]
>
> Si recibes un error que no corresponde a esta tabla, contáctanos en [empresas@vitawallet.io](mailto:empresas@vitawallet.io) y lo revisaremos.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.