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

# Elegir integración

> Compara los tipos de integración Seamless SDK, Lite SDK, Headless SDK y secure-fields para elegir la más adecuada

> [!NOTE]
>
> **Esta página documenta un SDK heredado.** ¿Vas a iniciar una nueva integración? Usa el [Yuno SDK](https://docs.y.uno/docs/yuno-sdk/get-started.md). ¿Ya usas un SDK heredado? Sigue la [guía de migración](https://docs.y.uno/docs/yuno-sdk/migration/overview.md).
>
> El nuevo **Yuno SDK** (Web v2.x, iOS v3.x, Android v3.x, React Native v2.x) reemplaza los SDK Full, Lite, Seamless, Render, Headless y Secure Fields con una sola API en todas las plataformas. Los SDK heredados siguen siendo compatibles en paralelo durante la transición y está previsto dejarlos de usar en **2027**. Contacta a tu Account Manager para planificar la migración.

¿No sabes por dónde empezar con el nuevo SDK? Consulta [¿Por dónde empiezo?](https://docs.y.uno/es/docs/yuno-sdk/where-do-i-start.md).

Dentro del SDK de cada plataforma, Yuno ofrece varios **métodos de integración** que te dan distintos grados de control sobre la UI y la experiencia del usuario.

El método de integración que elijas afecta el nivel de esfuerzo de mantenimiento requerido. También determina cómo administras los métodos de pago, que pueden ir desde una configuración sin código en el Yuno Dashboard hasta trabajo manual de desarrollo. Algunos tipos de integración también requieren certificaciones como **PCI-DSS** o **ISO**, lo que afecta tus obligaciones de cumplimiento.

> [!TIP]
>
> **Integración recomendada**
>
> Yuno recomienda usar **Seamless SDK** por su flexibilidad y facilidad de integración. Ofrece componentes de UI prediseñados y, al mismo tiempo, te da control total sobre la experiencia de pago y la visualización automática de los métodos de pago.

## Tipos de integración

A continuación, puedes ver las especificaciones de cada tipo de integración.

| Característica | seamless-sdk | lite-sdk | headless-sdk | secure-fields |
| :- | :-: | :-: | :-: | :-: |
| Agregar nuevos métodos de pago sin código | ✅ | ❌ | ❌ | ❌ |
| Manejar cientos de métodos de pago con una sola API | ✅ | ✅ | ✅ | ✅ |
| Tokenizar tarjetas y métodos de pago sin código | ✅ | ✅ | ✅ | ✅ |
| Usar la certificación PCI-DSS de Yuno | ✅ | ✅ | ✅ | ✅ |
| Usar 3D Secure | ✅ | ✅ | ✅ | ✅ |
| Usar una solución antifraude sin código | ✅ | ✅ | ✅ | ✅ |
| Definir condiciones de checkout con el Yuno Dashboard | ✅ | ❌ | ❌ | ❌ |
| Personalizar la apariencia de tu checkout con el Yuno Dashboard | ✅ | ❌ | ❌ | ❌ |

> [card] seamless-sdk
>
> La solución de integración más flexible y recomendada. Ofrece componentes de UI prediseñados con control total sobre la experiencia de pago y administración automática de los métodos de pago.
>
> * **Gestión de la experiencia del usuario**: tú controlas la UI mientras Yuno se encarga del trabajo pesado.
> * **Configuración sin código**: agrega y configura métodos de pago directamente desde el Dashboard.
> * **Flexibilidad**: ideal para negocios que buscan un equilibrio entre control y simplicidad.
> * **Equivalente en el nuevo SDK**: [Migración del modo Seamless (Web)](https://docs.y.uno/es/docs/yuno-sdk/migration/web/seamless.md).

> [card] lite-sdk
>
> Una integración ligera para tener el máximo control sobre el flujo de checkout y la visualización de los métodos de pago.
>
> * **Control total de la UI**: tú decides cómo y dónde mostrar cada método de pago.
> * **Orientada a desarrolladores**: requiere implementar manualmente la selección del método de pago.
> * **Personalizable**: ideal para negocios con requisitos de UX muy específicos. Usa [Web](https://docs.y.uno/es/docs/sdks/lite-web/payment.md), [Android](https://docs.y.uno/es/docs/sdks/lite-android/checkout.md) o [iOS](https://docs.y.uno/es/docs/sdks/lite-ios/checkout.md).
> * **Equivalente en el nuevo SDK**: [Migración del modo Lite (Web)](https://docs.y.uno/es/docs/yuno-sdk/migration/web/lite.md).

> [card] headless-sdk
>
> Máxima flexibilidad: tú construyes y administras toda la UI de pago, mientras Yuno se encarga de la lógica de pago subyacente y de la seguridad (como 3DS) mediante llamadas directas a funciones del SDK.
>
> * **Propiedad total de la UI**: no hay componentes prediseñados, cada pantalla e interacción la construyes tú.
> * **Orientada a desarrolladores**: tú solicitas y envías los campos obligatorios que exige cada proveedor de pago.
> * **Personalizable**: ideal para negocios que necesitan una experiencia de checkout totalmente personalizada. Usa [Web](https://docs.y.uno/es/docs/sdks/headless-web/payment.md), [Android](https://docs.y.uno/es/docs/sdks/headless-android/checkout.md) o [iOS](https://docs.y.uno/es/docs/sdks/headless-ios/checkout.md).
> * **Equivalente en el nuevo SDK**: [Migración del modo Headless (Web)](https://docs.y.uno/es/docs/yuno-sdk/migration/web/headless.md).

> [card] secure-fields
>
> Campos de entrada seguros prediseñados que incrustas directamente en tu propio formulario de pago, para que los datos sin procesar de la tarjeta nunca toquen tus servidores (solo Web).
>
> * **Recolección segura de datos**: simplifica la tokenización de los datos de la tarjeta de pago.
> * **Cumplimiento de PCI**: garantiza una experiencia que cumple con PCI con una UI personalizada.
> * **Solución equilibrada**: ideal para equilibrar seguridad y flexibilidad. Consulta la [implementación](https://docs.y.uno/docs/sdks/customization/secure-fields/index).
> * **Equivalente en el nuevo SDK**: [Secure Fields](https://docs.y.uno/es/docs/yuno-sdk/features/secure-fields.md).


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