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

# Lite SDK (Pago Android)

> Integra el Lite SDK en Android para una experiencia de checkout de pago con tarjeta simplificada

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

> [!WARNING]
>
> **Orientación: elige tu flujo de integración**. Antes de comenzar, revisa el [flujo de integración oficial](https://docs.y.uno/docs/sdks/overview/understanding-flows.md).
>
> * **Flujo estándar ([Full Checkout](https://docs.y.uno/docs/sdks/full-checkout/web-payments))**: Recomendado para la mayoría de los comercios. Yuno se encarga de la interfaz, la seguridad y las actualizaciones automáticas de los métodos de pago.
> * **Flujo personalizado (este SDK)**: Úsalo solo si necesitas control total sobre la experiencia de usuario. **Nota**: Serás responsable de gestionar manualmente los estados de los pagos, las transiciones de 3DS y la recopilación de datos para el enrutamiento de fraude.

Esta página es una guía del Yuno Lite SDK para pagos en Android. Este SDK ofrece un proceso de integración simplificado con las capacidades esenciales de pago, lo que lo hace ideal para comercios que:

* Necesitan una implementación rápida con requisitos mínimos de personalización
* Quieren centrarse principalmente en el procesamiento de pagos con tarjeta
* Prefieren una interfaz lista para usar que gestione el flujo de pago

El Lite SDK incluye funciones principales como:

* Componentes de interfaz de pago predefinidos
* Procesamiento de pagos con tarjeta
* Gestión básica del estado del pago
* Manejo esencial de errores

Para los comercios que requieren funciones más avanzadas, como varios métodos de pago, una interfaz personalizada o prevención de fraude avanzada, considera usar el [Full SDK](https://docs.y.uno/docs/sdks/full-checkout/android-payments) de Yuno.

## Requisitos

Antes de comenzar la integración del Yuno Android SDK, asegúrate de que tu proyecto cumpla los [requisitos técnicos](https://docs.y.uno/es/docs/sdks/resources/references/android.md). Además, asegúrate de contar con los siguientes prerrequisitos:

* Debes tener una cuenta activa de Yuno.
* Necesitas tus credenciales de la API de Yuno (`account_id`, `public-api-key` y `private-secret-key`), que puedes obtener en la [sección de credenciales de Developers](https://docs.y.uno/es/reference/getting-started/authentication.md) del Dashboard de Yuno.

## Paso 1: crea un cliente

Crea un cliente con el [endpoint Create customer](https://docs.y.uno/reference/customers/create-customer.md) antes de iniciar los pagos. El ID de cliente que devuelve este endpoint se usará al crear la `checkout_session`.

## Paso 2: crea una sesión de checkout

Crea una nueva `checkout_session` con el endpoint [Create checkout session](https://docs.y.uno/es/reference/checkout-sessions/create-checkout-session.md) para inicializar el flujo de pago.

## Paso 3: incluye la biblioteca en tu proyecto

Incluye el archivo del Yuno SDK en tu proyecto mediante Gradle. Agrega el origen del repositorio:

```kotlin theme={"theme":{"light":"github-dark","dark":"github-dark-dimmed"}}
maven { url "https://yunopayments.jfrog.io/artifactory/snapshots-libs-release" }
```

Incluye el siguiente código en el archivo `build.gradle` para agregar la dependencia del Yuno SDK:

```kotlin theme={"theme":{"light":"github-dark","dark":"github-dark-dimmed"}}
dependencies {
    implementation 'com.yuno.payments:android-sdk:2.27.0'
}
```

## Paso 4: inicializa el SDK con la clave pública

Inicializa el SDK llamando a `Yuno.initialize()` en el método `onCreate()` de tu aplicación:

```kotlin theme={"theme":{"light":"github-dark","dark":"github-dark-dimmed"}}
class CustomApplication : Application() {
  override fun onCreate() {
    super.onCreate()
    Yuno.initialize(
      this,
      PUBLIC_API_KEY,
      config = YunoConfig(
        saveCardEnabled = false,
        keepLoader = true,
        language = YunoLanguage.ENGLISH,
      )
    )
  }
}
```

### Personalización de YunoConfig

| Opción | Descripción |
| - | - |
| `saveCardEnabled` | Habilita la **casilla Guardar tarjeta**. |
| `keepLoader` | Si es `true`, el indicador de carga del SDK permanece desde la generación del OTT hasta que se llama a `continuePayment()`. Consulta [Parámetro keepLoader](https://docs.y.uno/es/docs/sdks/resources/references/android.md#keeploader-parameter). |
| `language` | Define el idioma como un valor `YunoLanguage` (por ejemplo, `SPANISH`, `ENGLISH`, `PORTUGUESE`). |
| `styles` | [Estilos](https://docs.y.uno/es/docs/sdks/resources/references/android.md#styles) predefinidos. |

## Paso 5: inicia el proceso de checkout

Llama al método `startCheckout` en tu activity:

```kotlin theme={"theme":{"light":"github-dark","dark":"github-dark-dimmed"}}
startCheckout(
  checkoutSession = "checkout_session",
  countryCode = "US",
  callbackPaymentState = { state, subState, message ->
    println("Payment State: $state, Substate: $subState, Error: ${message?.code}")
  }
)
```

### Estados del callback

| Estado | Descripción |
| - | - |
| `SUCCEEDED` | La transacción se completó correctamente. |
| `FAIL` | La transacción falló. |
| `PROCESSING` | En curso, a la espera de verificación. |
| `REJECT` | Rechazada (por ejemplo, fondos insuficientes). |
| `CANCELED_BY_USER` | El usuario canceló el proceso. |

## Paso 6: inicia el proceso de pago

Llama a `startPaymentLite` para iniciar el proceso:

```kotlin theme={"theme":{"light":"github-dark","dark":"github-dark-dimmed"}}
startPaymentLite(
    paymentSelected = PaymentSelected(
      paymentMethodType = "CARD",
      vaultedToken = null
    ),
    callbackOTT = { ott -> println("OTT: $ott") },
    callBackTokenWithInformation = { info -> println("Token Info: $info") },
    showPaymentStatus = true,
)
```

## Paso 7: crea el pago

Después de obtener el token de un solo uso (OTT), crea el pago desde tu backend con la API [Create Payment](https://docs.y.uno/es/reference/payments/create-payment.md).

## Paso 8: continúa el pago (obligatorio)

Si la respuesta de la API incluye `sdk_action_required: true`, llama a `continuePayment()`:

```kotlin theme={"theme":{"light":"github-dark","dark":"github-dark-dimmed"}}
continuePayment(
    showPaymentStatus = true,
    checkoutSession = "checkout_session",
    countryCode = "US",
    callbackPaymentState = { state, subState, message -> ... }
)
```

> [!NOTE]
>
> **Demo App**
>
> Consulta el [repositorio del Yuno Android SDK](https://github.com/yuno-payments/yuno-sdk-android) para ver ejemplos completos de implementación.


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