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

# Errores

> Formato de errores de la API y manejo desde el SDK.

Las respuestas no exitosas usan un formato estable:

```json theme={"dark"}
{
  "error": {
    "type": "invalid_request",
    "code": "price_not_found",
    "message": "No price exists with id price_xxxxx",
    "param": "lineItems[0].priceId",
    "requestId": "req_abc123"
  }
}
```

## Tipos comunes

| Tipo                   |          HTTP | Significado                                |
| ---------------------- | ------------: | ------------------------------------------ |
| `authentication_error` |      401, 403 | Key inválida, faltante o sin permisos      |
| `invalid_request`      | 400, 404, 422 | Parámetros inválidos o recurso inexistente |
| `idempotency_error`    |           409 | Reuso incompatible de una idempotency key  |
| `rate_limit_error`     |           429 | Demasiadas solicitudes                     |
| `api_error`            |           5xx | Error interno o temporal                   |

## Request ID

Incluye `requestId` cuando contactes soporte. Ayuda a rastrear la solicitud en logs.