> ## 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 error

> Tabla de referencia completa de códigos de error de la API de Sellers.

## Errores de CRUD de sellers

| Estado HTTP | Código de error |
| :- | :- |
| `400 Bad Request` | `DUPLICATE_PROVIDER_MAPPING` Se encontró una combinación `(provider.id, payment_method_type)` duplicada. |
| `400 Bad Request` | `VALIDATION_ERROR` El cuerpo de la solicitud no supera la validación. |
| `400 Bad Request` | `INVALID_PROVIDER` El `id` del proveedor no es válido. |
| `401 Unauthorized` | — Claves de API inválidas o ausentes. |
| `403 Forbidden` | `FORBIDDEN` Cuenta no encontrada o no autorizada. |
| `404 Not Found` | `FRANCHISE_MAPPING_NOT_FOUND` No existe ningún mapeo de seller para el ID indicado. |
| `409 Conflict` | `FRANCHISE_MAPPING_ALREADY_EXISTS` ya existe un mapeo con este `merchant_seller_id`. |

## Errores de solicitud de pago

| Estado HTTP | Código de error |
| :- | :- |
| `400 Bad Request` | `MUTUALLY_EXCLUSIVE_SELLER_REFERENCE` Se enviaron juntos `seller_id` y `merchant_seller_id`. |

## Resolución de franquicia (no bloqueante)

Estos escenarios **no** devuelven errores al comercio. El pago siempre continúa:

| Escenario | Comportamiento |
| :- | :- |
| Se encontró un mapeo para el proveedor enrutado | El pago usa el `merchant_id` resuelto y el detalle específico del tipo. |
| No hay mapeo para el proveedor enrutado / `payment_method_type` | Se registra una advertencia y se usa el `merchant_id` original de la conexión. |
| No hay datos de `payment_method` para este seller | Se registra una advertencia y se usa el `merchant_id` original de la conexión. |
| El servicio de resolución de franquicia no está disponible | Se registra un error y se usa el `merchant_id` original de la conexión. |
| No están presentes ni `seller_id` ni `merchant_seller_id` | La resolución de franquicia se omite por completo: sin impacto. |


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