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

> ## Agent Instructions
> Test in the sandbox first: base URL https://api-sandbox.y.uno (Test Mode in the Dashboard). Production is https://api.y.uno (Live Mode).
> Every API request needs the public-api-key and private-secret-key headers. Get them in the Dashboard at https://dashboard.y.uno/developers (Developers > Credentials); sandbox and production keys are different.
> Send an X-Idempotency-Key (a UUID) when creating payments, refunds and cancels, so retries do not create duplicates.
> Start with the Quickstart (https://docs.y.uno/docs/quickstart.md) and the agent guide (https://docs.y.uno/agents.md). To search these docs from a coding agent, connect the docs MCP server at https://docs.y.uno/mcp.

# Códigos de respuesta HTTP

> Lista los códigos de estado HTTP y los códigos de error que devuelve la API de Yuno, con su significado

Esta sección describe los códigos de error más comunes y sus soluciones que puedes encontrar al usar la API de Yuno.

Yuno usa códigos de respuesta HTTP estándar para indicar si las solicitudes a la API tuvieron éxito o fallaron.

Los códigos del rango 2xx suelen indicar éxito. Los códigos del rango 4xx indican un error causado por la información proporcionada (por ejemplo, un parámetro faltante). Los códigos del rango 5xx indican un error interno.

## Ejemplo

```json theme={"theme":{"light":"github-dark","dark":"github-dark-dimmed"}}
{
  "code": "INVALID_REQUEST",
  "messages": [
    "Invalid request."
  ]
}
```

## Atributos de la respuesta para errores

Consulta qué códigos devuelve la API REST de Yuno.

| Código de estado HTTP | Código | Descripción |
| :- | :- | :- |
| 400 Bad Request | `INVALID_REQUEST` | Solicitud inválida. |
| | `INVALID_PARAMETERS` | Parámetros inválidos: lista - \[parameter\_name]. |
| | `MISSING_PARAMETERS` | Parámetros faltantes: lista - \[parameter\_name]. |
| | `INVALID_STATUS` | Estado de la transacción inválido. |
| | `COUNTRY_NOT_SUPPORTED` | País no admitido. |
| | `CURRENCY_NOT_ALLOWED` | La moneda no está permitida para este país. |
| | `CUSTOMER_ID_DUPLICATED` | El id del cliente está duplicado para el comercio. |
| | `INVALID_AMOUNT` | Monto inválido para el método de pago. |
| | `INVALID_ACCOUNT_ID` | Id de cuenta de Yuno inválido |
| | `INVALID_TRANSACTION` | Id de transacción inválido |
| | `INVALID_API_VERSION` | Versión de la API inválida. |
| | `INVALID_TRANSACTION_TYPE` | Tipo de transacción inválido para la solicitud. |
| | `CHARGEBACK_IN_PROCESS` | Hay un contracargo en curso para esta transacción. |
| | `UNAVAILABLE_PAYMENT_METHOD` | Método de pago no disponible. |
| | `NOT_FOUND` | Recurso no encontrado. |
| | `UNEXPECTED_RESPONSE` | Respuesta inesperada del servicio. |
| | `BAD_REQUEST` | Ocurrió un error al ejecutar la solicitud. |
| | `INVALID_REPORT_ID` | El id del reporte debe ser un UUID. |
| | `INVALID_REPORT_TYPE` | Tipo de reporte inválido. |
| | `INVALID_DATE_FORMAT` | El formato de la fecha de inicio y fin debe ser yyyy-MM-dd'T'HH:mm:ss.SSS'Z'. |
| | `REPORT_MAX_RANGE_ERROR` | El rango máximo de fechas es de dos meses. |
| | `REPORT_RANGE_ERROR` | La fecha de inicio debe ser anterior a la fecha de fin. La fecha de inicio y fin debe ser posterior al momento actual. |
| | `REPORT_STATUS_ERROR` | El reporte aún no está listo, su estado es PROCESSING. |
| | `REPORT_EMPTY` | El reporte solicitado está vacío. |
| | `PAYMENT_METHOD_NOT_FOUND` | \[Para suscripciones] - No se encontró el método de pago asociado al cliente |
| | `PAYMENT_METHOD_STATUS_INVALID` | \[Para suscripciones] - El método de pago está en un estado que no permite realizar pagos. |
| | `INCORRECT_PAYMENT_METHOD_TYPE` | \[Para suscripciones] - El tipo de método de pago de la solicitud no corresponde al vaulted\_token. |
| | `SUBSCRIPTION_NOT_FOUND` | \[Para suscripciones] - Suscripción no encontrada. |
| | `INVALID_STATE` | \[Para suscripciones] - El estado de la suscripción no admite la acción solicitada. |
| | `INVALID_DATE` | \[Para suscripciones] - La suscripción no se puede reanudar por un conflicto con las fechas de disponibilidad. Actualiza las fechas de disponibilidad e inténtalo de nuevo si quieres seguir usando la suscripción |
| | `INVALID_PARAMETERS` | \[Para suscripciones] - Parámetros inválidos: lista - \[parameter\_name]. |
| | `INVALID_CUSTOMER_FOR_TOKEN` | El token usado en esta transacción está asociado a otro objeto de cliente. |
| | `PAYMENT_NOT_FOUND` | Pago no encontrado. |
| | `TRANSACTION_NOT_FOUND` | No se encontró la transacción del pago |
| | `CUSTOMER_NOT_FOUND` | Cliente no encontrado |
| | `CHECKOUT_SESSION_NOT_FOUND` | Sesión de checkout no encontrada o inactiva |
| | `REPORT_NOT_FOUND` | Id de reporte no encontrado |
| | `IDEMPOTENCY_DUPLICATED` | La idempotencia está duplicada. |
| 401 Unauthorized | `INVALID_CREDENTIALS` | Credenciales inválidas. |
| | `EXPIRED_CREDENTIALS` | Credenciales vencidas. |
| | `UNKNOWN_IP_ADDRESS` | Dirección IP no registrada. |
| | `INVALID_TOKEN` | Token inválido. |
| | `TOKEN_IN_USE` | El token proporcionado se está usando actualmente en otra solicitud. |
| 403 Forbidden | `AUTHORIZATION_REQUIRED` | El comercio no tiene autorización para usar esta API. |
| 405 Method not allowed | `UNSUPPORTED_METHOD` | Método no admitido. |
| 500 Internal Server Error | `INTERNAL_ERROR` | Error interno. |
| 504 Gateway Timeout | `REQUEST_TIMEOUT` | Tiempo de espera de la solicitud agotado. |


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