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

# Descripción general de la migración

> Pasa de cualquier modo anterior del Yuno SDK a la API unificada Transaction.

El SDK unificado reemplaza todos los modos anteriores del SDK (Full, Lite, Seamless, Render, Headless y Secure Fields) con una sola clase `Transaction`. Si actualmente usas alguno de esos modos, elige tu plataforma y tu modo anterior en la tabla siguiente. En React Native, las guías parten de la API 1.x de `@yuno-payments/yuno-sdk-react-native` y terminan en la 2.0.0.

## Encuentra tu guía

| Modo anterior | iOS | Android | Web | React Native |
| - | - | - | - | - |
| **Lite**: método preseleccionado, el SDK gestiona el formulario | [iOS](https://docs.y.uno/es/docs/yuno-sdk/migration/ios/payment/lite.md) | [Android](https://docs.y.uno/es/docs/yuno-sdk/migration/android/payment/lite.md) | [Web](https://docs.y.uno/es/docs/yuno-sdk/migration/web/lite.md) | [React Native](https://docs.y.uno/es/docs/yuno-sdk/migration/react-native/payment/lite.md) |
| **Full**: el SDK renderiza la lista de métodos de pago | [iOS](https://docs.y.uno/es/docs/yuno-sdk/migration/ios/payment/full.md) | [Android](https://docs.y.uno/es/docs/yuno-sdk/migration/android/payment/full.md) | [Web](https://docs.y.uno/es/docs/yuno-sdk/migration/web/full.md) | [React Native](https://docs.y.uno/es/docs/yuno-sdk/migration/react-native/payment/full.md) |
| **Render**: insertas el formulario del SDK en tu propio diseño | [iOS](https://docs.y.uno/es/docs/yuno-sdk/migration/ios/payment/render.md) | [Android](https://docs.y.uno/es/docs/yuno-sdk/migration/android/payment/render.md) | *(no aplica)* | *(no aplica: nuevo en la 2.0.0, consulta [`showView`](https://docs.y.uno/es/docs/yuno-sdk/controllers/show-view))* |
| **Headless**: recopilas los datos en tu propia interfaz | [iOS](https://docs.y.uno/es/docs/yuno-sdk/migration/ios/payment/headless.md) | [Android](https://docs.y.uno/es/docs/yuno-sdk/migration/android/payment/headless.md) | [Web](https://docs.y.uno/es/docs/yuno-sdk/migration/web/headless.md) | [React Native](https://docs.y.uno/es/docs/yuno-sdk/migration/react-native/payment/headless.md) |
| **Seamless**: creación del pago gestionada por el SDK con inicio activado por el comercio | [iOS](https://docs.y.uno/es/docs/yuno-sdk/migration/ios/payment/seamless.md) | [Android](https://docs.y.uno/es/docs/yuno-sdk/migration/android/payment/seamless.md) | [Web](https://docs.y.uno/es/docs/yuno-sdk/migration/web/seamless.md) | *(no aplica)* |
| **Seamless Lite**: Seamless con un método preseleccionado | *(no aplica)* | *(no aplica)* | [Web](https://docs.y.uno/es/docs/yuno-sdk/migration/web/seamless-lite.md) | [React Native](https://docs.y.uno/es/docs/yuno-sdk/migration/react-native/payment/seamless-lite.md) |
| **Secure Fields**: datos de tarjeta recopilados en iframes compatibles con PCI | *(no aplica)* | *(no aplica)* | [Web](https://docs.y.uno/es/docs/yuno-sdk/migration/web/secure-fields.md) | *(no aplica)* |
| **Inscripción**: guarda un método de pago sin realizar un cobro | [Lite](https://docs.y.uno/es/docs/yuno-sdk/migration/ios/enrollment/lite.md) · [Render](https://docs.y.uno/es/docs/yuno-sdk/migration/ios/enrollment/render.md) · [Headless](https://docs.y.uno/es/docs/yuno-sdk/migration/ios/enrollment/headless.md) | [Lite](https://docs.y.uno/es/docs/yuno-sdk/migration/android/enrollment/lite.md) · [Render](https://docs.y.uno/es/docs/yuno-sdk/migration/android/enrollment/render.md) · [Headless](https://docs.y.uno/es/docs/yuno-sdk/migration/android/enrollment/headless.md) | [Web](https://docs.y.uno/es/docs/yuno-sdk/migration/web/enrollment.md) | [Lite](https://docs.y.uno/es/docs/yuno-sdk/migration/react-native/enrollment/lite.md) · [Headless](https://docs.y.uno/es/docs/yuno-sdk/migration/react-native/enrollment/headless.md) |
| **Estado**: pantalla independiente del estado del pago | *(no aplica)* | *(no aplica)* | [Web](https://docs.y.uno/es/docs/yuno-sdk/migration/web/status.md) | *(no aplica)* |
| **Fraude**: huella digital del dispositivo | *(no aplica)* | *(no aplica)* | [Web](https://docs.y.uno/es/docs/yuno-sdk/migration/web/fraud.md) | *(no aplica)* |

## Qué cambió

Cada modo anterior corresponde a la misma clase `Transaction`. El nombre del modo desaparece. Lo que pasas a la configuración y los controllers que sobrescribes determinan el comportamiento:

* **El tipo de sesión** (`checkoutSession` frente a `customerSession`) determina si se trata de un pago o de una inscripción.
* **El controller `createPayment`** determina si el SDK crea el pago o lo hace tu backend. Si no lo sobrescribes, el SDK gestiona la creación del pago de principio a fin (el equivalente de Seamless).
* **El controller `showView`** (iOS, Android, React Native) determina si el SDK presenta el formulario a pantalla completa o te entrega la vista para que la insertes (el equivalente de Render).
* **`transactionData` en `PaymentMethodSelected`** (iOS, Android, React Native) o **`data` en el `paymentMethod` que pasas a `start()`** (Web) determina si el SDK muestra un formulario o tokeniza datos que ya recopilaste (el equivalente de Headless).
* **`getPaymentMethodsViews`** reemplaza todas las API anteriores de montaje de listas y de botones externos de billeteras (el equivalente de Full).

> [!NOTE]
>
> **3DS nativo en iOS:** los módulos nativos de 3DS aún no están disponibles para el SDK de iOS 3.x, por lo que los desafíos de 3DS se ejecutan en un WebView presentado por el SDK. Consulta [Módulos nativos](https://docs.y.uno/es/docs/yuno-sdk/features/native-modules.md#netcetera-3ds).

Cada guía tiene la misma estructura: qué resolver antes de empezar, una comparación de código lado a lado y una tabla de lo que cambia, con qué hacer en cada caso.


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