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

# Entendiendo los flujos

> Entiende los flujos de pago, inscripción, token almacenado y Headless SDK con diagramas y secuencias de pasos

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

En los Yuno SDK, los **flujos de pago** y los **flujos de inscripción** son independientes. El pago es el proceso de completar una transacción. La inscripción es el proceso de guardar un método de pago (por ejemplo, una tarjeta) en la cuenta de un cliente para usarlo en el futuro. Esta página explica ambos flujos a alto nivel con diagramas y secuencias de pasos. Usa la [Guía de inicio rápido](https://docs.y.uno/es/docs/sdks/overview/quickstart.md) y las páginas de flujo de cada plataforma ([Web](https://docs.y.uno/docs/sdks/full-checkout/web-payments), [iOS](https://docs.y.uno/docs/sdks/full-checkout/ios-payments), [Android](https://docs.y.uno/docs/sdks/full-checkout/android-payments)) para ver los detalles de implementación.

## Flujo de pago

El SDK ofrece una experiencia de pago unificada: los clientes completan transacciones con varios métodos de pago en una sola integración. El siguiente diagrama ilustra el flujo de pago principal.

[Diagrama del flujo de pago](https://yuno-diagrams-public.pages.dev/diagrams/sdks/overview/understanding-flows/full-checkout-flow.html)

SolicitudRespuestaÉxito

### Pasos del flujo de pago

1. Servidor del comercio: `Create Customer` → Servidor de Yuno: `Creates Customer`
2. Cliente del comercio: `Initiate Checkout` → Servidor del comercio: `Create Checkout session`
3. Servidor del comercio: `Create Checkout session` → Servidor de Yuno: `Creates Checkout session`
4. Cliente del comercio: `Initiate Checkout` → `Initiate SDK` to continue payment flow
5. Cliente del comercio: `Initiate SDK` to continue payment flow → Yuno SDK: `Receive checkout session`
6. Yuno SDK: `Receive checkout session` → `List payment methods`
7. Yuno SDK: `List payment methods` → El usuario selecciona los métodos de pago
8. Yuno SDK: El usuario selecciona los métodos de pago → Callback con el `one-time token`
9. Yuno SDK: Callback con el `one-time token` → Cliente del comercio: Recibe el `one-time token` (de un solo uso)
10. Cliente del comercio: Recibe el `one-time token` (de un solo uso) → `Initiate payment`
11. Cliente del comercio: `Initiate payment` → `Initiate SDK` to continue payment flow
12. Cliente del comercio: `Initiate SDK` to continue payment flow → Yuno SDK: `Continue with the payment flow`
13. Yuno SDK: `Continue with the payment flow` → Muestra una pantalla para que el usuario complete el pago
14. Yuno SDK: Muestra una pantalla para que el usuario complete el pago → Muestra el `payment result` (opcional)
15. Cliente del comercio: `Initiate payment` → Servidor del comercio: `Create payment`
16. Servidor del comercio: `Create payment` → Servidor de Yuno: `Creates payment` en el proveedor de pago

### Flujo de pago con un token almacenado

Si un cliente tiene un método de pago inscrito, puede usar un **token almacenado** (vaulted token) para pagar sin volver a ingresar los datos de pago.

[Diagrama del flujo de pago con un token almacenado](https://yuno-diagrams-public.pages.dev/diagrams/sdks/overview/understanding-flows/payment-flow-using-vaulted-token.html)

SolicitudRespuestaÉxito

#### Pasos del flujo con token almacenado

1. Cliente del comercio: `Initiate checkout` → Servidor del comercio: `Create Customer`
2. Servidor del comercio: `Create Customer` → Servidor de Yuno: `Create Customer`
3. Cliente del comercio: `Initiate SDK` con la `checkout session` → Yuno SDK: `Receive checkout session`
4. Yuno SDK: `Receive checkout session` → `List payment methods`
5. Yuno SDK: `List payment methods` → El usuario selecciona los métodos de pago
6. Yuno SDK: El usuario selecciona el método de pago → Callback con el `one-time token`
7. Yuno SDK: Callback con el `one-time token` → Cliente del comercio: `Initiate payment`
8. Cliente del comercio: `Initiate payment` → Servidor del comercio: `Create payment`
9. Servidor del comercio: `Create payment` → Servidor de Yuno: `Creates payment` en el proveedor de pago
10. Cliente del comercio: Muestra el `payment result` → Servidor del comercio: `Receive payment result`
11. Servidor del comercio: `Receive payment result` → Servidor de Yuno: Proporciona el `payment result`

## Flujo de inscripción

La **inscripción** es el proceso de guardar un método de pago (por ejemplo, una tarjeta) en la cuenta de un cliente para poder usarlo más adelante (por ejemplo, con un token almacenado). full-checkout admite la inscripción; el siguiente diagrama describe el flujo de inscripción.

[Diagrama del flujo de inscripción](https://yuno-diagrams-public.pages.dev/diagrams/sdks/overview/understanding-flows/payment-method-enrollment-flow.html)

SolicitudRespuestaÉxito

### Pasos del flujo de inscripción

1. Servidor del comercio: `Create Customer` → Servidor de Yuno: `Creates Customer`
2. Cliente del comercio: `Add payment method` → Servidor del comercio: `Create customer session`
3. Servidor del comercio: `Create customer session` → Servidor de Yuno: `Creates customer session`
4. Cliente del comercio: `Display payment methods to enroll` → Servidor del comercio: `Request available payment methods to enroll`
5. Servidor del comercio: `Request available payment methods to enroll` → Servidor de Yuno: `Returns available payment method`
6. Cliente del comercio: `Display payment methods to enroll` → Cliente del comercio: El usuario selecciona el método de pago que desea inscribir
7. Cliente del comercio: El usuario selecciona el método de pago que desea inscribir → Cliente del comercio: `Initiate enrollment`
8. Cliente del comercio: `Initiate enrollment` → Cliente del comercio: `Initiate SDK` to continue enrollment
9. Cliente del comercio: `Initiate SDK` to continue enrollment → Yuno SDK: `Continue enrollment flow`
10. Yuno SDK: `Continue enrollment flow` → Yuno SDK: Muestra pantallas para que el usuario complete la inscripción
11. Servidor del comercio: Recibe el `enrollment result` mediante webhook → Servidor de Yuno: Recibe los `enrollment results` del proveedor de pago
12. Servidor de Yuno: Recibe los `enrollment results` del proveedor de pago → Yuno SDK: Muestra el `enrollment result` (opcional)

## Flujo del Headless SDK

El **Headless SDK** ofrece máxima flexibilidad al permitirte gestionar toda la interfaz de usuario, mientras Yuno se encarga de la lógica de pago compleja y de la seguridad (como 3DS).

[Diagrama del flujo del Headless SDK](https://yuno-diagrams-public.pages.dev/diagrams/sdks/overview/understanding-flows/headless-sdk-flow.html)

SolicitudRespuestaÉxito

### Pasos del flujo headless

1. Servidor del comercio: `Create Customer` → Servidor de Yuno: `Creates Customer`
2. Cliente del comercio: `Initiate Checkout` → Servidor del comercio: `Create Checkout session`
3. Cliente del comercio: `Collect Information` → El usuario ingresa los datos de la tarjeta o del método de pago en tu interfaz personalizada.
4. Cliente del comercio: `Generate Token` → Yuno SDK: Llama a `generateToken(details)` para recibir un `one-time token`.
5. Cliente del comercio: `Process Payment` → Servidor del comercio: Envía el `one-time token` a tu backend.
6. Servidor del comercio: `Create Payment` → Servidor de Yuno: Llama a la API [Create Payment](https://docs.y.uno/es/reference/payments/create-payment.md).
7. Cliente del comercio: `Handle Actions` → Si la respuesta de la API devuelve `sdk_action_required: true`, usa el SDK para gestionar 3DS u otras [acciones de pago](https://docs.y.uno/es/docs/sdks/headless-web/payment.md#step-7-get-payment-actions).


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