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

# Descripción general de conexiones y enrutamiento

> Referencia orientada al comercio sobre la nueva superficie de la API pública que te permite crear conexiones con proveedores de pago y configurar cómo Yuno enruta los pagos entre ellas.

Las conexiones son la forma de integrar tus cuentas existentes con proveedores de pago (Stripe, Adyen, dLocal, PayU, …) en la orquestación de Yuno. Una vez que existe una conexión, puedes referenciarla desde una regla de enrutamiento para enviar pagos a través de ese proveedor.

Un enrutamiento le indica a Yuno, para un `payment_method` en una cuenta, qué conexión usar, y te permite ramificar por atributos del comprador (país, moneda, monto, marca de la tarjeta, metadata personalizada, …).

## Contrato común

### URL base

```text theme={"theme":{"light":"github-dark","dark":"github-dark-dimmed"}}
https://api.y.uno
```

### Autenticación y encabezados

| Encabezado | Obligatorio | Notas |
| - | - | - |
| `public-api-key` | sí | Tu clave de API pública de comercio. La cuenta a la que pertenece esta clave determina sobre qué cuenta opera la solicitud. |
| `private-secret-key` | sí | Tu clave secreta privada de comercio. |
| `X-Idempotency-Key` | en `POST` y `PATCH` | UUID, con alcance de 24 horas. Reenviar la misma clave y el mismo cuerpo devuelve la respuesta almacenada en caché; la misma clave con un cuerpo distinto devuelve un `409`. |
| `Content-Type: application/json` | sí | |

> [!NOTE]
>
> Usa una clave de cuenta o una clave de organización. Las claves de **Developers → Customized API keys** del dashboard se rechazan hoy en todos los endpoints `/v1/routing*` y `/v1/connections*`.

### Convenciones

* Los nombres de campo usan `snake_case` en todas partes: solicitud, respuesta y errores. La única excepción está dentro de `params[]` en la respuesta del **catálogo de proveedores**, donde los valores individuales de `param_id` se pasan con su formato original (`merchantAccount`, `HMAC_KEY`, `apple-merchant-id`, etc.) y debes repetirlos textualmente al crear una conexión.
* El sobre de error es el mismo en todos los endpoints:

```json theme={"theme":{"light":"github-dark","dark":"github-dark-dimmed"}}
{
  "type": "validation_error",
  "code": "MISSING_REQUIRED_PARAM",
  "message": "Required param 'merchantAccount' is missing for provider 'ADYEN'",
  "details": { "provider_id": "ADYEN", "param_id": "merchantAccount" }
}
```

Los valores estables de `code` se listan por endpoint.


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