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

# Seamless SDK

> El Seamless SDK de Yuno ofrece una integración simple y eficiente, y te da control total sobre la experiencia de pago.

> [!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.

Al igual que el [Lite SDK](https://docs.y.uno/es/docs/sdks/overview/quickstart.md), el Seamless SDK te permite obtener los métodos de pago disponibles y decidir cuáles mostrar durante el checkout. Una vez hecha la selección, una sola llamada a la API y al SDK completa el proceso de pago, y crea una experiencia idéntica a la del Lite SDK.

Con el Seamless SDK puedes:

* Ejecutar el proceso de pago.
* Inscribir una tarjeta de crédito mientras realizas un pago, configurando `vault_on_success: true` al crear el pago.
* Usar un token almacenado de un método de pago inscrito para completar un pago.

Usa las siguientes guías para implementar cada proceso.

![Descripción general del Seamless SDK](https://files.readme.io/bb2c987a467228d113d98035f453a459aedfb41554aad3eb49fc50fed8dbf0a0-Screenshot_2025-06-04_at_10.45.05_AM.png)

## Flujo de pago

El siguiente diagrama ilustra el flujo de pago completo:

![Flujo de pago del Seamless SDK](https://files.readme.io/aa0edc30b1470562f8cc1380856aacb410d41aa6417d863e2c65476d26481fa4-image1.png)

### Flujo de pago headless del SDK

Este diagrama ilustra el proceso de pago headless con el SDK y detalla las interacciones entre el cliente del comercio, el servidor del comercio, el servidor de Yuno y el Yuno SDK. Describe los pasos desde el inicio de un checkout y la solicitud de métodos de pago hasta la creación del pago y la recepción de su resultado.

#### Cliente del comercio

El cliente del comercio representa tu app, que interactúa tanto con tu servidor backend como con el Yuno SDK. Se encarga de los aspectos de cara al usuario del flujo de pago, entre ellos:

* Listar los métodos de pago
* El usuario selecciona un método de pago
* Iniciar el SDK con la sesión de checkout y `payment_method`

#### Servidor del comercio

El servidor del comercio representa tu app, que se encarga de las operaciones del lado del servidor y se comunica con los servidores de Yuno. Sus responsabilidades principales incluyen:

* Crear la `checkout_session`
* Recibir el webhook con el resultado del pago

#### Servidor de Yuno

El servidor de Yuno se encarga de todas las operaciones de backend relacionadas con la gestión de clientes, las sesiones de checkout y el procesamiento de pagos. Sus responsabilidades principales incluyen:

* Crea la `checkout_session`
* Crear el pago
* Envía el webhook con el resultado del pago

#### Yuno SDK

El Yuno SDK se encarga de la interfaz de usuario y del flujo de pago del lado del cliente, y gestiona la selección del método de pago, la generación del token y la finalización del pago. Sus responsabilidades principales incluyen:

* Iniciar el SDK con `checkout_session` y `payment_method`
* Generar el OTT
* Continuar el pago automáticamente si es necesario
* Mostrar las pantallas para que el usuario complete la inscripción
* Mostrar el resultado del método de pago (opcional)

#### Flujo

Los siguientes pasos describen el flujo de interacción completo entre todos los componentes de la integración de pago headless del SDK, y detallan cómo se mueve cada solicitud y respuesta por el sistema:

1. Servidor del comercio: crear `checkout_session` --> Servidor de Yuno: crea `checkout_session`
2. Cliente del comercio: iniciar el SDK con la sesión de checkout y `payment_method` --> Yuno SDK: iniciar el SDK con `checkout_session` y `payment_method`
3. Servidor de Yuno: crear el pago --> Yuno SDK: generar el OTT

## Configuración del SDK por plataforma

Para implementar la integración del Full SDK, sigue las guías específicas de cada plataforma a continuación:

> [card] [Web](https://docs.y.uno/es/docs/sdks/seamless-sdk/web-payments.md)
>
> Integra el Seamless SDK en aplicaciones Web.

> [card] [iOS](https://docs.y.uno/es/docs/sdks/seamless-sdk/ios-payments.md)
>
> Integra el Seamless SDK en aplicaciones iOS.

> [card] [Android](https://docs.y.uno/es/docs/sdks/seamless-sdk/android-payments.md)
>
> Integra el Seamless SDK en aplicaciones Android.


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