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

# Connections

> Agrega, edita y gestiona conexiones con proveedores de métodos de pago, procesadores y soluciones antifraude

La sección Connections del Dashboard te permite integrar y gestionar varios proveedores, entre ellos métodos de pago, procesadores de pago y soluciones antifraude. Poder conectarte con proveedores de todo el mundo mediante Yuno reduce considerablemente los tiempos de integración y suma funcionalidades para tus clientes, lo que aumenta la comodidad y los ingresos.

Veamos el proceso de agregar, crear y gestionar conexiones para mejorar tus capacidades de procesamiento de pagos y enrutamiento.

## Agregar una conexión

1. La pestaña **Explore** se muestra por defecto al abrir Connections en el Dashboard. Desde aquí, recorre la lista de proveedores disponibles o usa el cuadro **Search** para encontrar la conexión que buscas. Los proveedores pueden ser métodos de pago, procesadores y soluciones antifraude. Haz clic en **Connect** para continuar.

![Página de proveedores en el Dashboard con la pestaña Your connections seleccionada, que lista conexiones como Adyen, Cybersource 3DS, Mercado Pago, Yuno 3DS y Yuno Test Payment Gateway, cada una con nombre, tipo de flujo, métodos de pago y estado Active](https://mintcdn.com/yuno-3979e326/mqKc4056TZzyLssc/images/reference/connections/image1.png?fit=max\&auto=format\&n=mqKc4056TZzyLssc\&q=85\&s=7b0cd3ab337ef85c9cedd6627da5b95e)

2. Después de seleccionar un proveedor, comenzarás el proceso rápido de tres pasos para configurar la conexión. Primero, se te pedirán las credenciales del proveedor, necesarias para establecer una conexión segura. Escribe un nombre fácil de recordar para la conexión y luego ingresa los datos requeridos. La información específica que debes ingresar varía según el proveedor, aunque lo más probable es que ya la tengas. Si tienes dudas sobre alguno de estos campos o te falta información, consulta al proveedor. De forma opcional, puedes marcar **3DS Credentials** e ingresar los datos requeridos para activar la función. Haz clic en **Next**.

![Pantalla Add Mercado Pago connection que muestra el paso 1 de 3, Set up credentials, con secciones desplegables sobre cómo obtener credenciales, webhooks, redirecciones de URL, consideraciones y onboarding de submerchants, seguidas de los campos Name y Country](https://mintcdn.com/yuno-3979e326/mqKc4056TZzyLssc/images/reference/connections/image2.png?fit=max\&auto=format\&n=mqKc4056TZzyLssc\&q=85\&s=cfab05bb4b9a3f19d0871f1de3b10bff)

3. La siguiente pantalla, **Set up costs**, te permite ingresar información de costos para usar en Smart Routing y en las conciliaciones (Fees). Selecciona **Set up cost** para ingresar los costos de los pagos exitosos y no exitosos. Esta opción es totalmente opcional, así que puedes hacer clic en **Next** sin ingresar datos.

4. **Set up accounts** te permite seleccionar las cuentas que se verán afectadas por los cambios. Marca cuentas específicas o **Current account only** y haz clic en **Save** para terminar. El sistema confirmará que la conexión se creó, y establecerá un puente entre tu cuenta de Yuno y el proveedor elegido.

> [!NOTE]
>
> **Edición de conexiones**
>
> Cuando creas conexiones, se configura una conexión por cada cuenta que selecciones. Si necesitas hacer cambios más adelante, debes editar cada conexión de forma individual: la edición masiva no es compatible.

5. Con tus conexiones configuradas, puedes pasar a la sección [Routing](https://docs.y.uno/es/docs/using-yuno/dashboard-overview/routing.md) para configurar rutas de procesamiento de pagos con el proveedor y los métodos de pago que tienes disponibles en Yuno.

> [!NOTE]
>
> **Configurar costos para conexiones nuevas**
>
> Cuando agregas una conexión nueva, puedes configurar sus costos. Este paso opcional te permite definir costos distintos para los pagos exitosos y no exitosos, para ayudarte a gestionar las comisiones con la [función Smart Routing](https://docs.y.uno/es/docs/using-yuno/dashboard-overview/routing.md#smart-routing).
>
> Puedes definir costos predeterminados para todos los pagos y agregar condiciones específicas para distintas situaciones, como establecer un costo único cuando un cliente usa Visa.
>
> Los costos se aplican en el orden en que los creas, pero puedes reordenarlos arrastrando y soltando. Esta configuración ayuda a Yuno Payments a elegir automáticamente la ruta más económica para cada transacción cuando activas Smart Routing.
>
> Los costos se usan tanto para Smart Routing como para las comisiones (Fees) en las conciliaciones.

## Gestionar conexiones

La pestaña **Your connections** dentro de Connections te permite gestionar las conexiones existentes para adaptarlas a las necesidades cambiantes de tu negocio. Las acciones disponibles incluyen:

* **Editar conexiones**: Actualiza fácilmente las credenciales o cambia la configuración de una conexión seleccionando los tres puntos junto a la conexión y luego **Edit**.
* **Pausar y reactivar conexiones**: Para detener temporalmente la interacción con un proveedor específico, puedes elegir **Pause** en una conexión. Cuando quieras reanudarla, selecciona **Unpause**. Esta flexibilidad te permite adaptarte a circunstancias cambiantes sin tener que rehacer tus conexiones.
* **Eliminar conexiones**: Si una conexión ya no es necesaria, puedes eliminarla. Ten cuidado al eliminar conexiones, ya que esta acción es irreversible.
* **Gestionar varias conexiones**: Marca la casilla junto a dos o más conexiones para pausarlas, reactivarlas y eliminarlas de forma masiva.

## Configuración de metadatos dinámicos

La función Dynamic Metadata te permite controlar qué campos de metadatos se envían a cada proveedor conectado, y configurar exactamente qué claves de metadatos se envían desde la configuración de tu conexión. Esto es especialmente útil cuando distintos proveedores requieren metadatos diferentes.

Para usar Dynamic Metadata:

1. Activa la opción "Dynamic Metadata Configuration" en la configuración de tu conexión.
2. Configura las asignaciones de claves desde los metadatos de tu API pública a los metadatos específicos del proveedor.
3. Solo las claves de metadatos configuradas se enviarán al proveedor durante las transacciones.

> [!NOTE]
>
> **Importante para usuarios de Stripe**
>
> La lógica actual de metadatos en Stripe se eliminará el **29 de agosto de 2025**. Asegúrate de actualizar tu conexión para usar la asignación dinámica antes de esa fecha, para evitar cualquier interrupción en tu procesamiento de pagos.


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