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

# Usa Yuno con asistentes de IA

> Conecta Yuno con el asistente de IA que ya usas (Claude, ChatGPT o Grok, próximamente) para analizar los datos de tus pagos, buscar en la documentación de la API de Yuno y operar pagos en tus cuentas de Yuno con lenguaje natural.

Conecta tu cuenta de Yuno con el asistente de IA que ya usas. Analiza los datos de tus pagos, busca en la documentación de la API de Yuno y opera pagos en las cuentas de Yuno a las que tienes acceso, todo con lenguaje natural. Inicias sesión con tu usuario de Yuno, por lo que el asistente solo ve y actúa sobre lo que tu usuario y tu organización tienen permitido.

> [!NOTE]
>
> Si eres desarrollador y quieres integrar flujos de pago en tu propio agente en lugar de usar este conector listo para usar, consulta [Creación de integraciones de IA con los LLM y el MCP de Yuno](https://docs.y.uno/es/docs/ai-capabilities/building-ai-integrations-with-yunos-llms-and-mcp.md) y el [Servidor MCP remoto de Yuno](https://docs.y.uno/es/docs/ai-capabilities/remote-yuno-mcp-server.md).

## Configuración

> [tab] Claude
>
> La forma más rápida de habilitar Yuno en Claude es a través del directorio de conectores.
>
> **1. Abre la ficha del conector de Yuno**
>
> Abre la [ficha del conector de Yuno](https://claude.ai/directory/connectors/yuno) en el directorio de Claude.
>
> **2. Conecta y autoriza**
>
> Haz clic en **Connect** e inicia sesión con tus credenciales de Yuno para autorizar el acceso a tu cuenta.
>
> **3. Habilita Yuno en tu chat**
>
> En cualquier chat, abre el menú de búsqueda y herramientas y asegúrate de que **Yuno** esté activado.
>
> **4. Haz tu primera pregunta**
>
> Prueba con: *"¿Qué cuentas de Yuno puedo usar?"*
>
> > [!NOTE]
> >
> > Los conectores agregados desde el directorio se sincronizan automáticamente en claude.ai, Claude Desktop y las apps móviles, por lo que solo necesitas conectarte una vez.

> [tab] ChatGPT
>
> Habilita la app de Yuno desde el directorio de apps de ChatGPT.
>
> **1. Abre la ficha de la app de Yuno**
>
> Abre la [ficha de la app de Yuno](https://chatgpt.com/plugins/plugin_asdk_app_6a3eabbf663c819186dda21300243f8e) en ChatGPT.
>
> **2. Agrega y vincula tu cuenta**
>
> Haz clic en **Add** (o **Connect**) e inicia sesión con tus credenciales de Yuno para vincular tu cuenta.
>
> **3. Invoca la app**
>
> En un chat nuevo, invoca la app por su nombre: escribe `@Yuno`, o simplemente haz una pregunta sobre pagos y ChatGPT llamará a las herramientas de Yuno cuando sea relevante.
>
> **4. Haz tu primera pregunta**
>
> Prueba con: *"Usando Yuno, ¿qué cuentas puedo usar?"*

> [tab] Grok
>
> > [!NOTE]
> >
> > **Próximamente.** El conector de Yuno para Grok está en desarrollo y aún no ha sido aprobado. Los pasos de configuración y un enlace a la ficha se agregarán aquí cuando esté disponible.

## Cuentas

Las acciones de pago se ejecutan en una de tus cuentas de Yuno. De forma predeterminada, el conector usa tu cuenta principal: la que está definida como predeterminada para tu usuario de Yuno en el dashboard o, si no hay ninguna, la primera cuenta a la que tienes acceso.

* Pregunta **"¿Qué cuentas de Yuno puedo usar?"** para ver la lista de cuentas disponibles para ti y cuál es la predeterminada.
* Indica al asistente qué cuenta usar en una solicitud determinada (por ejemplo, "usa la cuenta `<account>`") para cambiar la cuenta predeterminada.
* Las cuentas a las que no tienes acceso se rechazan: el conector solo puede usar las cuentas a las que tu usuario de Yuno tiene derecho.

## Modelo de seguridad

* **Analytics es de solo lectura**: las sentencias SQL que modifican datos o el esquema siempre se rechazan.
* **Las herramientas de pago pueden escribir**: pueden crear y modificar datos. Según tu configuración de Claude o ChatGPT, el asistente puede pedir tu aprobación antes de ejecutarlas.
* **Confirmación en producción**: en producción, las cancelaciones, los reembolsos y las eliminaciones devuelven primero una vista previa y solo se ejecutan después de que el asistente lo confirme en un plazo de 5 minutos.
* Los permisos provienen del acceso y la organización de tu usuario de Yuno, no del asistente: solo puede hacer lo que tu cuenta ya tiene permitido hacer.

## Qué puedes hacer

El conector expone herramientas en cuatro grupos de capacidades: analytics, documentación de la API de Yuno, cuentas y pagos. El asistente elige automáticamente la herramienta adecuada, por lo que nunca tienes que llamarlas por su nombre, pero saber qué hay disponible te ayuda a saber qué pedir.

### Analytics (SQL de solo lectura)

| Herramienta | Tipo | Descripción |
| - | - | - |
| `read_query` | Read | Ejecuta SQL de solo lectura (`SELECT`, `WITH`, `SHOW`, `DESCRIBE`, `EXPLAIN`) sobre tus datos de analytics. Esto impulsa la mayoría de las preguntas: métricas, desgloses, tendencias, exportaciones. |
| `table_overview` | Read | Describe las columnas y los tipos de una tabla y muestra algunas filas de ejemplo, para que el asistente conozca la forma de tus datos antes de consultarlos. |
| `analyze_query` | Read | Devuelve el plan de ejecución de una consulta sin ejecutarla, para poder comprobar primero las consultas costosas. |

### Documentación de la API de Yuno

| Herramienta | Tipo | Descripción |
| - | - | - |
| `docs__search_yuno_api_documentation` | Read | Busca en la documentación pública de la API de Yuno. |
| `docs__query_docs_filesystem_yuno_api_documentation` | Read | Lee páginas de la documentación. |
| `docs__submit_feedback` | Write | Informa al equipo de documentación sobre una página de la documentación incorrecta o desactualizada. |

### Cuentas

| Herramienta | Tipo | Descripción |
| - | - | - |
| `yuno_list_accounts` | Read | Lista las cuentas de Yuno que puedes usar y marca la predeterminada. |

### Pagos

Las herramientas de pago tienen el prefijo `pay__` y se agrupan por recurso a continuación. El asistente puede obtener por sí mismo los parámetros completos de cualquier herramienta de pago mediante `pay__describeTool`, por lo que esta página agrupa las herramientas por recurso en lugar de listar cada parámetro.

| Recurso | Herramientas | Tipo |
| - | - | - |
| Helper | `pay__describeTool` | Read (devuelve los parámetros completos de una herramienta de pago) |
| [Pagos](https://docs.y.uno/reference/payments/manage-payments.md) | `pay__paymentRetrieve`, `pay__paymentRetrieveByMerchantOrderId` | Read |
| | `pay__paymentCreate`, `pay__paymentAuthorize` | Write |
| | `pay__paymentCaptureAuthorization`, `pay__paymentCancel`, `pay__paymentRefund`, `pay__paymentCancelOrRefund`, `pay__paymentCancelOrRefundWithTransaction` | Destructive |
| [Clientes](https://docs.y.uno/reference/customers/the-customer-object.md) | `pay__customerRetrieve`, `pay__customerRetrieveByExternalId` | Read |
| | `pay__customerCreate`, `pay__customerUpdate` | Write |
| [Métodos de pago](https://docs.y.uno/reference/payment-methods-direct-workflow/the-payment-method-object-api.md) | `pay__paymentMethodRetrieve`, `pay__paymentMethodRetrieveEnrolled` | Read |
| | `pay__paymentMethodEnroll` | Write |
| | `pay__paymentMethodUnenroll` | Destructive |
| [Checkout](https://docs.y.uno/reference/checkout-sessions/the-checkout-session-object.md) | `pay__checkoutSessionRetrievePaymentMethods` | Read |
| | `pay__checkoutSessionCreate`, `pay__checkoutSessionCreateOtt` | Write |
| [Suscripciones](https://docs.y.uno/reference/subscriptions/the-subscription-object.md) | `pay__subscriptionRetrieve` | Read |
| | `pay__subscriptionCreate`, `pay__subscriptionResume`, `pay__subscriptionUpdate` | Write |
| | `pay__subscriptionPause`, `pay__subscriptionCancel` | Destructive |
| [Enlaces de pago](https://docs.y.uno/reference/payment-links/the-payment-link-object.md) | `pay__paymentLinkRetrieve` | Read |
| | `pay__paymentLinkCreate` | Write |
| | `pay__paymentLinkCancel` | Destructive |
| [Destinatarios](https://docs.y.uno/reference/recipients-for-marketplace/the-recipient-object.md) | `pay__recipientRetrieve` | Read |
| | `pay__recipientCreate`, `pay__recipientUpdate` | Write |
| | `pay__recipientDelete` | Destructive |
| [Planes de cuotas](https://docs.y.uno/reference/installments/create-installments-plan.md) | `pay__installmentPlanRetrieve`, `pay__installmentPlanRetrieveAll` | Read |
| | `pay__installmentPlanCreate`, `pay__installmentPlanUpdate` | Write |
| | `pay__installmentPlanDelete` | Destructive |

**Read** = sin cambios. **Write** = crea o actualiza datos. **Destructive** = cancela, reembolsa o elimina; requiere confirmación en producción.

## Pregunta en lenguaje natural

* "¿Cuál fue mi tasa de aprobación de pagos por método de pago en los últimos 30 días?"
* "Muestra el volumen de transacciones por país en julio y señala cualquier país que haya bajado más de un 10 % respecto a junio."
* "¿Cuáles son los 5 principales motivos de rechazo de este mes y de qué proveedor provienen?"
* "Compara la conversión entre tarjeta de crédito y PIX en Brasil este trimestre."
* "Describe la tabla de transacciones y muéstrame algunas filas de ejemplo."
* "Prepárame un resumen semanal: volumen, tasa de aprobación, tasa de reembolsos y ticket promedio."
* "¿Cómo creo un pago con 3DS?"
* "¿Qué cuentas de Yuno puedo usar?"
* "Reembolsa el pago `<payment_id>`."
* "Crea un enlace de pago por 50 USD."

## Limitado a tu cuenta

* **Limitado a tu cuenta**: el conector se autentica con tus credenciales de Yuno y solo puede ver y actuar sobre las cuentas a las que tu usuario tiene derecho. Consulta [Modelo de seguridad](#safety-model) para saber cómo se mantienen seguras las analíticas de solo lectura y las escrituras de pagos.
* **Límites de consulta**: los conjuntos de resultados muy grandes se truncan en lugar de transmitirse completos, y las sesiones tienen un límite de velocidad para mantener sano el almacén de datos. Para exportaciones masivas, usa el dashboard o la API de Yuno.
* **Interrupciones parciales**: si una capacidad (analytics, documentación o pagos) deja de estar disponible temporalmente, solo desaparecen sus herramientas; el resto sigue funcionando.

## Solución de problemas

**Claude indica que el conector de Yuno está desconectado**

Ve a Settings → Connectors, busca Yuno y haz clic en Reconnect; luego vuelve a autorizar. Si el conector no aparece en un chat, comprueba que esté habilitado en el menú de búsqueda y herramientas del chat.

**ChatGPT no llama a la app de Yuno**

Invócala de forma explícita escribiendo `@Yuno` al inicio de tu mensaje, o menciona "usando Yuno" en el prompt. Si sigue sin estar disponible, elimina la app y vuelve a agregarla desde su ficha del directorio.

**Las consultas fallan con un error de "no database selected"**

Pide al asistente que califique las tablas con el nombre de su base de datos (por ejemplo, `analytics.transactions`) o que indique qué base de datos usar. Preguntar primero "¿qué tablas hay disponibles?" suele resolver el problema.

**Los resultados parecen truncados**

Es lo esperado con salidas grandes. Pide al asistente que agregue los datos (totales, top-N, resúmenes agrupados) en lugar de listar filas sin procesar, o que reduzca el rango de fechas.

**El asistente usó la cuenta equivocada**

Pregunta "¿Qué cuentas de Yuno puedo usar?" e indícale cuál usar para la solicitud.

**"Confirmation expired"**

Las confirmaciones en producción duran 5 minutos. Pide al asistente que repita la acción para obtener una confirmación nueva.

**Mensaje "Connect" o "consent required"**

El asistente te está pidiendo que (re)autorices el conector de Yuno: tu sesión o un consentimiento previo caducó o no se completó. Vuelve a pasar por el paso de conexión (consulta Configuración arriba) y reintenta tu solicitud.

## Preguntas frecuentes

> [accordion] ¿Los conectores de Claude, ChatGPT y Grok hacen lo mismo?
>
> Sí. Los tres exponen las mismas herramientas de Yuno: analytics, documentación y pagos. Elige el asistente que tu equipo ya usa, o conecta más de uno; el acceso y los permisos son idénticos porque los rige tu credencial de Yuno, no el asistente. (Grok llegará próximamente.)

> [accordion] ¿Puede el conector mover dinero o cambiar la configuración de mis pagos?
>
> Puede ejecutar operaciones de pago (crear, capturar, cancelar y reembolsar pagos, y administrar clientes, suscripciones, enlaces de pago, destinatarios y planes de cuotas) en las cuentas de Yuno a las que tienes acceso. No puede cambiar la configuración de tu dashboard ni de enrutamiento de Yuno. Las acciones destructivas en producción requieren un paso de confirmación explícito. Para operaciones de pago programáticas desde tu propio agente, consulta [Creación de integraciones de IA con los LLM y el MCP de Yuno](https://docs.y.uno/es/docs/ai-capabilities/building-ai-integrations-with-yunos-llms-and-mcp.md) y el [Servidor MCP remoto de Yuno](https://docs.y.uno/es/docs/ai-capabilities/remote-yuno-mcp-server.md).

> [accordion] ¿Se usan mis datos para entrenar modelos de IA?
>
> Tus datos se transfieren al asistente únicamente dentro de tu propia conversación, sujetos a las políticas de datos de Anthropic o de OpenAI según tu plan. Consulta la política de manejo de datos de IA de tu espacio de trabajo; los planes empresariales de ambos proveedores excluyen por defecto los datos de negocio del entrenamiento.

> [accordion] ¿Puedo conectar Yuno a mi propio agente o IDE como desarrollador?
>
> Sí. Yuno publica un servidor MCP que puedes usar desde Cursor, Claude Code o cualquier cliente compatible con MCP. Consulta el [Servidor MCP remoto de Yuno](https://docs.y.uno/es/docs/ai-capabilities/remote-yuno-mcp-server.md) y [Creación de integraciones de IA con los LLM y el MCP de Yuno](https://docs.y.uno/es/docs/ai-capabilities/building-ai-integrations-with-yunos-llms-and-mcp.md).

> [accordion] ¿A quién contacto si algo no funciona?
>
> Comunícate con tu gerente de cuenta de Yuno o abre un ticket desde el dashboard de Yuno. Para problemas de desarrolladores con el servidor MCP, repórtalos en [GitHub](https://github.com/yuno-payments/yuno-mcp).


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