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

# ¿Qué es Yuno?

> Yuno es el sistema operativo de IA para pagos: una API y un SDK te conectan con proveedores de pago, bancos, herramientas antifraude y métodos de pago locales, con agentes de IA encima. Tu primer pago, cómo funciona, los objetos principales, las opciones de integración y el índice de productos.

Cómo funciona Yuno

Introducción

# ¿Qué es Yuno?

Yuno es el sistema operativo de IA para pagos.

[Obtén claves de sandbox](https://docs.y.uno/es/docs/quickstart.md)
[Elige una integración](#integrate)

```bash cURL theme={"theme":{"light":"github-dark","dark":"github-dark-dimmed"}}
curl --request POST \
  --url https://api-sandbox.y.uno/v1/payments \
  --header "public-api-key: $YUNO_PUBLIC_API_KEY" \
  --header "private-secret-key: $YUNO_PRIVATE_SECRET_KEY" \
  --header "X-Idempotency-Key: $(uuidgen)" \
  --header "content-type: application/json" \
  --data '{
    "account_id": "'"$YUNO_ACCOUNT_ID"'",
    "merchant_order_id": "order-0001",
    "description": "First test payment",
    "country": "US",
    "amount": { "currency": "USD", "value": 25 },
    "workflow": "DIRECT",
    "payment_method": {
      "type": "CARD",
      "detail": { "card": { "card_data": {
        "number": "4507990000000002",
        "expiration_month": 11,
        "expiration_year": 28,
        "security_code": "123",
        "holder_name": "John Doe"
      } } }
    }
  }'
```

```javascript Node.js theme={"theme":{"light":"github-dark","dark":"github-dark-dimmed"}}
const res = await fetch("https://api-sandbox.y.uno/v1/payments", {
  method: "POST",
  headers: {
    "public-api-key": process.env.YUNO_PUBLIC_API_KEY,
    "private-secret-key": process.env.YUNO_PRIVATE_SECRET_KEY,
    "X-Idempotency-Key": crypto.randomUUID(),
    "content-type": "application/json",
  },
  body: JSON.stringify({
    account_id: process.env.YUNO_ACCOUNT_ID,
    merchant_order_id: "order-0001",
    description: "First test payment",
    country: "US",
    amount: { currency: "USD", value: 25 },
    workflow: "DIRECT",
    payment_method: {
      type: "CARD",
      detail: { card: { card_data: {
        number: "4507990000000002",
        expiration_month: 11,
        expiration_year: 28,
        security_code: "123",
        holder_name: "John Doe",
      } } },
    },
  }),
});
const payment = await res.json();
console.log(payment.status); // SUCCEEDED
```

```python Python theme={"theme":{"light":"github-dark","dark":"github-dark-dimmed"}}
import os
import uuid
import requests

res = requests.post(
    "https://api-sandbox.y.uno/v1/payments",
    headers={
        "public-api-key": os.environ["YUNO_PUBLIC_API_KEY"],
        "private-secret-key": os.environ["YUNO_PRIVATE_SECRET_KEY"],
        "X-Idempotency-Key": str(uuid.uuid4()),
    },
    json={
        "account_id": os.environ["YUNO_ACCOUNT_ID"],
        "merchant_order_id": "order-0001",
        "description": "First test payment",
        "country": "US",
        "amount": {"currency": "USD", "value": 25},
        "workflow": "DIRECT",
        "payment_method": {
            "type": "CARD",
            "detail": {"card": {"card_data": {
                "number": "4507990000000002",
                "expiration_month": 11,
                "expiration_year": 28,
                "security_code": "123",
                "holder_name": "John Doe",
            }}},
        },
    },
)
print(res.json()["status"])  # SUCCEEDED
```

Esta solicitud es real y se ejecuta en sandbox, así que cópiala, define tus claves y ejecútala. [Ejecútala en el playground de la API](https://docs.y.uno/es/reference/payments/create-payment.md). La configuración de sandbox está en el [Quickstart](https://docs.y.uno/es/docs/quickstart.md). En producción, enviar datos de tarjeta desde tu servidor requiere PCI DSS.

Base URLs
Sandbox `https://api-sandbox.y.uno/v1`
Production `https://api.y.uno/v1`

Auth
Headers `public-api-key` and `private-secret-key`
Keys start with `sandbox_` or `prod_`

Writes
Send `X-Idempotency-Key` when you create a payment
Amounts in major units: `25` is USD 25.00

For agents
[openapi.json](https://docs.y.uno/openapi.json)[llms.txt](https://docs.y.uno/llms.txt)[AGENTS.md](https://docs.y.uno/AGENTS.md)[Docs MCP](https://docs.y.uno/setup-mcp.md)[Remote MCP](https://docs.y.uno/docs/ai-capabilities/remote-yuno-mcp-server.md)

<video src="https://docs.y.uno/videos/explainers/how-yuno-works.mp4" poster="/videos/explainers/how-yuno-works.jpg" controls preload="none" playsInline aria-label="Cómo funciona Yuno en 60 segundos" />

Video: Cómo funciona Yuno en 60 segundos (60 s, captions on screen, no voiceover)

01 / Cómo funciona

## Tu app habla con Yuno. Yuno habla con todos los demás.

Agregas proveedores y cambias el enrutamiento en el Dashboard. Tu código no cambia.

Integra una sola vezTu app

Orquesta![Yuno](https://mintcdn.com/yuno-3979e326/nstGsSlveKgBOAkB/logo/yuno_wordmark_white.svg?fit=max\&auto=format\&n=nstGsSlveKgBOAkB\&q=85\&s=e1fa9f7cd1cc977066151ae5220044c2)Conecta cualquieraProveedoresYuno SDKAPI directaEnlaces de pagoMCPPresencial (POS)

Agentes de IAEnrutamientoFraude y 3DSVaultConciliaciónPayouts

PSPs y adquirentesBancosMétodos de pago localesHerramientas de fraude y 3DS

02 / Objetos principales

## Cuatro objetos, en el orden en que los usas.

Todos los pagos siguen esta secuencia, con cualquier método y cualquier proveedor.

<ol>
  <li>
    [1
    Cliente Opcional
    `POST /v1/customers`
    El pagador. Guarda sus datos y sus métodos de pago para reutilizarlos.](https://docs.y.uno/es/docs/basic-concepts/customers)
  </li>

  <li>
    [2
    Sesión de checkout
    `POST /v1/checkout/sessions`
    El monto y el país. El SDK la usa para mostrar los métodos de pago que tu cuenta tiene habilitados.](https://docs.y.uno/es/docs/basic-concepts/sessions)
  </li>

  <li>
    [3
    Pago
    `POST /v1/payments`
    El cobro. Contiene las transacciones: autorización, captura y reembolso.](https://docs.y.uno/es/docs/basic-concepts/payments-1)
  </li>

  <li>
    [4
    Webhook
    `Yuno → tu servidor`
    Yuno envía cada cambio de estado a una URL que registras en el Dashboard o por API.](https://docs.y.uno/es/docs/basic-concepts/webhooks-1)
  </li>
</ol>

El SDK convierte los datos de la tarjeta en un token de un solo uso (OTT) que envías con el pago. La API directa omite la sesión y envía los datos de la tarjeta desde tu servidor, lo que requiere PCI DSS. Secuencia completa: [Flujo de pago](https://docs.y.uno/es/docs/how-yuno-works/how-yuno-payment-flow-works.md).

03 / Elige tu integración

## Elige qué parte del flujo controlas.

Las cuatro usan los mismos objetos y las mismas claves de API.

[Recomendado
Yuno SDK
Web, iOS y Android. El SDK muestra el checkout y deja los datos de la tarjeta fuera de tu alcance PCI.](https://docs.y.uno/docs/yuno-sdk/introduction)

[Servidor a servidor
API directa
Tu backend llama a la API y controla todo el flujo. Los datos de tarjeta requieren PCI DSS.](https://docs.y.uno/docs/direct-integration-use-cases/direct-flow.md)

[Sin código
Enlaces de pago
Una URL de checkout alojada, creada en el Dashboard o por API.](https://docs.y.uno/docs/using-yuno/dashboard-overview/payment-links.md)

[Agentes de IA
Servidor MCP remoto
Los agentes llaman a la API de Yuno como herramientas MCP, autenticados con tus claves de API.](https://docs.y.uno/docs/ai-capabilities/remote-yuno-mcp-server.md)

También: [Flutter](https://docs.y.uno/docs/sdks/additional-platforms/flutter.md), [React Native](https://docs.y.uno/docs/sdks/additional-platforms/react-native/index.md), [WooCommerce](https://docs.y.uno/docs/plugins/woocommerce/index.md), [VTEX](https://docs.y.uno/docs/plugins/vtex/index.md). Para construir con un agente de código, consulta [Construir con IA](https://docs.y.uno/docs/ai-capabilities/build-with-ai.md).

04 / Índice de productos

## Todo lo demás que hace Yuno.

Una línea por producto. Cada enlace abre la guía o la referencia de la API.

IA

<ul>
  <li>[**NOVA**Recupera pagos rechazados por WhatsApp o por llamada de voz](https://docs.y.uno/docs/ai-capabilities/nova.md)</li>
  <li>[**Payment Concierge**Un analista de IA para tus datos de pago](https://docs.y.uno/docs/ai-capabilities/payment-concierge.md)</li>
  <li>[**Maia**Technical account manager con IA para tu configuración](https://docs.y.uno/docs/ai-capabilities/maia-ai-technical-account-manager.md)</li>
  <li>[**Agent Toolkit**Crea experiencias de pago con IA en tu framework](https://docs.y.uno/docs/ai-capabilities/agent-toolkit.md)</li>
  <li>[**Servidor MCP remoto**La API de Yuno como herramientas para agentes de IA](https://docs.y.uno/docs/ai-capabilities/remote-yuno-mcp-server.md)</li>
</ul>

Aceptar

<ul>
  <li>[**Métodos de pago**Tarjetas, billeteras y métodos locales](https://docs.y.uno/docs/basic-concepts/payment-methods.md)</li>
  <li>[**Suscripciones**Planes y facturación recurrente](https://docs.y.uno/docs/payment-features/subscriptions/index.md)</li>
  <li>[**Pagos divididos**Pagos de marketplace entre varios destinatarios](https://docs.y.uno/docs/payment-features/split-payments-marketplace.md)</li>
  <li>**Presencial (POS)**Pagos con tarjeta presente en terminales de tienda</li>
  <li>**Cripto**Consulta con tu equipo de cuenta en Yuno</li>
</ul>

Optimizar

<ul>
  <li>[**Enrutamiento inteligente**Un proveedor por pago, con respaldo ante un rechazo](https://docs.y.uno/docs/using-yuno/dashboard-overview/routing.md)</li>
  <li>[**Recomendaciones de enrutamiento *Beta***Rutas ordenadas según tu propio historial](https://docs.y.uno/reference/organizations/routing/get-routing-recommendations.md)</li>
  <li>[**Reintentos de transacciones**Reintenta capturas y reembolsos fallidos](https://docs.y.uno/docs/payment-features/transaction-retries.md)</li>
  <li>[**Network tokens**Tokens de red en lugar de números de tarjeta](https://docs.y.uno/docs/security-and-compliance/network-tokens.md)</li>
  <li>[**Card account updater**Actualiza tarjetas guardadas vencidas o reemplazadas](https://docs.y.uno/docs/additional-services/card-account-updater.md)</li>
</ul>

Proteger

<ul>
  <li>[**Prevención de fraude**Análisis con herramientas antifraude externas](https://docs.y.uno/docs/basic-concepts/fraud)</li>
  <li>[**3D Secure**Autenticación del titular de la tarjeta en el pago](https://docs.y.uno/docs/security-and-compliance/3d-secure.md)</li>
  <li>[**3DS standalone**Solo autenticación, sin autorización](https://docs.y.uno/docs/payment-features/3ds-standalone.md)</li>
  <li>[**Vault y tokens**Guarda tarjetas una vez y reutilízalas entre proveedores](https://docs.y.uno/docs/basic-concepts/tokens.md)</li>
  <li>[**PCI Proxy**Envía datos de tarjeta a APIs de terceros](https://docs.y.uno/docs/security-and-compliance/pci-proxy/overview.md)</li>
</ul>

Operar

<ul>
  <li>[**Conciliación**Cruza las transacciones con las liquidaciones](https://docs.y.uno/docs/using-yuno/dashboard-overview/reconciliations.md)</li>
  <li>[**Reportes**Datos de pago en un solo formato](https://docs.y.uno/docs/direct-integration-use-cases/build-reports.md)</li>
  <li>[**Payouts**Envía dinero a destinatarios](https://docs.y.uno/docs/payouts-and-disputes/payouts.md)</li>
  <li>[**Disputas**Gestiona contracargos entre proveedores](https://docs.y.uno/docs/payouts-and-disputes/chargeback-management.md)</li>
  <li>[**Conectividad bancaria**Cuentas bancarias, transferencias, onboarding de entidades](https://docs.y.uno/reference/banking-connectivity/index.md)</li>
</ul>

Siguientes pasos

## Tu primer pago en sandbox.

<ol>
  <li>[1Quickstart TutorialConecta el gateway de pruebas y envía un pago en sandbox.](https://docs.y.uno/es/docs/quickstart.md)</li>
  <li>[2Developers ReferenciaURLs base, claves, specs, versiones de SDK y herramientas.](https://docs.y.uno/docs/developers.md)</li>
  <li>[3Flujo de pago ConceptoCada paso de un pago, campo por campo.](https://docs.y.uno/es/docs/how-yuno-works/how-yuno-payment-flow-works.md)</li>
  <li>[4Referencia de la API ReferenciaCada endpoint, con sus esquemas de solicitud y de respuesta.](https://docs.y.uno/reference/getting-started/api-reference-overview.md)</li>
</ol>

¿Un término no está claro? Consulta el [Glosario](https://docs.y.uno/docs/glossary.md).


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