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

# Build with AI

> Instala e integra el Yuno SDK con tu agente de código con IA.

> [!TIP]
>
> **Programación con IA**: conecta la documentación de Yuno directamente con tu
> agente de IA local (Claude Code, Cursor, Windsurf) para recibir asistencia en
> tiempo real. Cada página de esta documentación es legible por IA mediante **Copy page**.

## Instala con IA

La integración más rápida es la que hace tu agente por ti. Pega esto en
Claude Code, Cursor o cualquier agente de código. Lee la guía
[Get Started](https://docs.y.uno/es/docs/yuno-sdk/get-started.md), lo configura todo
y termina con un pago de prueba para que sepas que funciona:

```text theme={"theme":{"light":"github-dark","dark":"github-dark-dimmed"}}
Read https://docs.y.uno/docs/yuno-sdk/get-started and integrate
the Yuno SDK into this project:

1. Load https://sdk-web.y.uno/v2.5.1/main.js with a script tag,
   or npm install @yuno-payments/sdk-web@^10 and call loadScript().
   Do not install 9.x or older of that package: those load SDK 1.x
2. Initialize SdkPayments once with the public API key from my env
3. Add a backend endpoint that creates a checkout session
   (workflow: "SDK_SEAMLESS")
4. Start a Transaction with onStatus wired, then run a sandbox
   test payment with card 4507 9900 0000 0002, expiry 11/28,
   CVV 123, cardholder John Doe
```

El número de tarjeta es una tarjeta de prueba: solo funciona en sandbox, no
se mueve dinero real. Más información en [Tarjetas de prueba](https://docs.y.uno/es/docs/yuno-sdk/get-started.md#test-cards).

## Conecta tu agente (MCP)

MCP es el conector que une tu agente de IA directamente con Yuno. Una vez añadido,
tu agente puede crear sesiones de prueba, consultar pagos y probar flujos
por ti, sin salir de tu editor:

```json theme={"theme":{"light":"github-dark","dark":"github-dark-dimmed"}}
{
  "mcpServers": {
    "yuno": {
      "url": "https://mcp.y.uno/v1"
    }
  }
}
```

> [!NOTE]
>
> El servidor MCP y el Agent Toolkit están documentados en
> [AI capabilities](https://docs.y.uno/es/docs/ai-capabilities/building-ai-integrations-with-yunos-llms-and-mcp.md);
> los detalles del endpoint y de la autenticación están allí.

## Skills listos para usar

Los skills son conocimiento preempaquetado: enseñan a tu agente los flujos de Yuno para que
no tengas que explicárselos. *(Propuesto, en definición con el equipo de
AI capabilities.)*

| Skill | Qué hace |
| - | - |
| `yuno-sdk-install` | Genera la integración completa: instalación, inicialización, endpoint de sesión y controladores conectados. |
| `yuno-test-payment` | Ejecuta pagos en sandbox con los escenarios de tarjetas de prueba e informa los resultados. |
| `yuno-migrate` | Asigna una integración anterior (Full, Lite, Seamless…) a la API `Transaction` unificada. |

## Documentación que tu agente puede leer (llms.txt)

Cada página de esta documentación también se publica en un formato que los agentes pueden leer
por sí solos, indexado en [docs.y.uno/llms.txt](https://docs.y.uno/llms.txt).
Apunta a tu agente allí y podrá explorar la documentación sin
tu ayuda.


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