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

> SDKs de Yuno para iOS, Android, React Native y Web.

Prueba ahora nuestro Yuno SDK

Configura un checkout y míralo actualizarse en vivo, sin cuenta ni
código.

[Pruébalo ahora →](https://sdk-webview.dev.y.uno/playground.html)

Métodos de pago

![](https://mintcdn.com/yuno-3979e326/wcaoTPfNIXrvnpRG/images/yuno-sdk/pix.svg?fit=max\&auto=format\&n=wcaoTPfNIXrvnpRG\&q=85\&s=f1623b96e3812de4d05a91ff43c7a5d7)

PIX

![](https://mintcdn.com/yuno-3979e326/wcaoTPfNIXrvnpRG/images/yuno-sdk/card.svg?fit=max\&auto=format\&n=wcaoTPfNIXrvnpRG\&q=85\&s=6eb2faee4e6eda8a8092294b95982221)

Card

Pagar R\$150.00

initialize
start()
onStatus · SUCCEEDED ✓

> [!WARNING]
>
> **Los SDK heredados están programados para su desuso en 2027.** Estos documentos cubren el nuevo Yuno SDK (Web 2.x, iOS 3.x, Android 3.x, React Native 2.x). ¿Sigues en un SDK heredado? Consulta la [Guía de migración](https://docs.y.uno/es/docs/yuno-sdk/migration/overview.md). Contacta a tu Account Manager para la planificación de la migración, los plazos o soporte.

Una integración, todas las plataformas. Los SDK de Yuno para iOS, Android, React Native
y Web comparten la misma API unificada, así que lo que construyes una vez funciona en todas partes: la
misma `Transaction`, el mismo `start()`, la misma configuración.

Inicializa el SDK con tu clave de API y empieza una `Transaction` para cada
pago o inscripción. A partir de ahí, el SDK lleva a tu comprador desde elegir
un método hasta un pago finalizado: formularios, tokenización, 3DS y el estado
final, todo lo gestiona el SDK por ti. [Cómo fluye una transacción](https://docs.y.uno/es/docs/yuno-sdk/how-a-transaction-flows.md) muestra la secuencia paso a paso.

[iOS
· Swift
↗](https://github.com/yuno-payments/yuno-sdk-ios/tree/release-3.1.0)

[Android
· Kotlin
↗](https://github.com/yuno-payments/yuno-sdk-android)

[Web
· JavaScript
↗](https://github.com/yuno-payments/yuno-sdk-web/tree/main/v2)

[React Native
· TypeScript
↗](https://www.npmjs.com/package/@yuno-payments/yuno-sdk-react-native)

> [!NOTE]
>
> ¿Usas Flutter? Este SDK aún no lo cubre. Consulta la documentación del [SDK de Flutter](https://docs.y.uno/es/docs/sdks/additional-platforms/flutter.md).

## Empieza con el checkout predeterminado

El SDK incluye un checkout completo: lista de métodos, formularios, 3DS y resultados.
Yuno lo renderiza y lo ejecuta todo; tú solo escuchas el resultado con
`onStatus`.

El formulario que renderiza está ajustado para que los compradores terminen en segundos, sin nada
que configurar. Consulta
[Un checkout más rápido](https://docs.y.uno/es/docs/yuno-sdk/features/form-behavior.md) para ver más
ejemplos de lo que lo acelera.

> [card] [Usa nuestro checkout predeterminado](https://docs.y.uno/es/docs/yuno-sdk/checkout-preview.md)
>
> **Recomendado.** Nada que construir y nada que sobrescribir.
> **Míralo en vivo en el playground →**

## ¿Quieres más control?

Sobrescribe solo la pieza que necesitas. Todo lo demás sigue funcionando
de forma predeterminada:

UI de carga
El indicador de carga que ven los compradores mientras el SDK trabaja.

Predeterminado

Tuyo

[showLoading →](https://docs.y.uno/es/docs/yuno-sdk/controllers/show-loading.md)

Dónde se renderizan los formularios
Incrusta los formularios del SDK en tus propias pantallas. Solo móvil.

Predeterminado

Tuyo

[showView →](https://docs.y.uno/es/docs/yuno-sdk/controllers/show-view.md)

El formulario en sí
Recopila los datos de pago en tu propia interfaz.

Predeterminado

Tuyo

[transactionData →](https://docs.y.uno/es/docs/yuno-sdk/reference/objects-you-pass.md#transaction-data)

Creación del pago
Tu backend crea el pago en lugar del SDK.

Predeterminado

Tuyo

[createPayment →](https://docs.y.uno/es/docs/yuno-sdk/controllers/create-payment.md)

¿No sabes qué piezas necesitas? [¿Por dónde empiezo?](https://docs.y.uno/es/docs/yuno-sdk/where-do-i-start.md)
te guía por cada decisión, caso por caso.

## Elige un tipo de sesión

La misma clase `Transaction` gestiona dos flujos:

* Pasa una **`checkoutSession`** para procesar un pago.
* Pasa una **`customerSession`** para inscribir un método de pago sin
  cobrar.

Consulta [Sesiones](https://docs.y.uno/es/docs/basic-concepts/sessions.md) para más detalles.

## Requisitos del backend

Los SDK son solo del lado del cliente. Tu backend debe:

1. Crear sesiones de checkout o de cliente.
   * **Sesión de checkout**: consulta [`POST /v1/checkout/sessions`](https://docs.y.uno/es/reference/checkout-sessions/create-checkout-session).
   * **Sesión de cliente**: consulta [`POST /v1/customers/sessions`](https://docs.y.uno/es/reference/customer-sessions-enrollment/create-customer-session).

Consulta [Primeros pasos](https://docs.y.uno/es/docs/yuno-sdk/get-started.md) para el recorrido completo de la
integración del backend.

## Migrar desde una versión anterior

Si actualmente usas uno de los SDK heredados (Full, Lite, Seamless,
Render, Headless, Secure Fields), la nueva API unificada los reemplaza a
todos con una sola clase `Transaction`. Tu integración existente
seguirá funcionando, pero las nuevas funciones y mejoras se publican en el
SDK unificado.

Consulta la [Guía de migración](https://docs.y.uno/es/docs/yuno-sdk/migration/overview.md) para ver una correspondencia de los
modos heredados con la nueva API y las instrucciones paso a paso para cada
plataforma.

## Próximos pasos

> [card] [Primeros pasos](https://docs.y.uno/es/docs/yuno-sdk/get-started.md)
>
> Instala, inicializa y procesa tu primer pago.

> [card] [¿Por dónde empiezo?](https://docs.y.uno/es/docs/yuno-sdk/where-do-i-start.md)
>
> Decide qué parámetros y controllers se ajustan a tu integración.

> [card] [Crea con IA](https://docs.y.uno/es/docs/yuno-sdk/build-with-ai.md)
>
> Instala e integra el SDK con tu agente de codificación con IA.

> [card] [Controllers](https://docs.y.uno/es/docs/yuno-sdk/controllers/overview.md)
>
> Controla el renderizado, el envío y el manejo de resultados.

> [card] [Guías](https://docs.y.uno/es/docs/yuno-sdk/features/payment-methods-list.md)
>
> Lista de métodos de pago, inscripción, deeplinks, estilos.

> [card] [Referencia](https://docs.y.uno/es/docs/yuno-sdk/reference/objects-you-pass.md#transaction-config)
>
> Configuración, selección de método de pago, datos de la transacción, estado.

> [card] [Migración](https://docs.y.uno/es/docs/yuno-sdk/migration/overview.md)
>
> Pasa de Lite, Full, Render, Headless o Seamless al SDK unificado.


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