> ## 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 (inscripción en Android)

> Inscribe métodos de pago con el Lite SDK en Android mediante un flujo de inscripción ligero

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

Sigue esta guía paso a paso para implementar y habilitar la función de inscripción del Lite SDK de Yuno para Android en tu app.

## Paso 1: incluye la biblioteca en tu proyecto

Antes de continuar con la implementación del Lite SDK, consulta la [Guía de inicio rápido](https://docs.y.uno/es/docs/sdks/overview/quickstart.md) para ver las instrucciones detalladas sobre cómo integrar correctamente el SDK en tu proyecto.

Elige el método de integración que mejor se adapte a tu flujo de desarrollo y a tus requisitos técnicos. Después de completar la integración del SDK, puedes continuar con los siguientes pasos para implementar la funcionalidad de inscripción lite.

## Paso 2: inicializa el SDK

Inicializa el Yuno SDK en tu clase `Application` proporcionando un `PUBLIC_API_KEY` válido:

```kotlin theme={"theme":{"light":"github-dark","dark":"github-dark-dimmed"}}
class MyApplication : Application() {
    override fun onCreate() {
        super.onCreate()
        Yuno.initialize(
            this,
            apiKey = "YOUR_PUBLIC_API_KEY",
            config = YunoConfig()
        )
    }
}
```

> [!NOTE]
>
> **Credenciales**
>
> Consulta la página de credenciales para obtener más información: [/reference/getting-started/authentication](https://docs.y.uno/es/reference/getting-started/authentication.md)

## Paso 3: crea una sesión de cliente

Para iniciar el proceso de inscripción, debes proporcionar el `customer_session`. Primero, debes crear un cliente. Usa el endpoint [Crear cliente](https://docs.y.uno/reference/customers/create-customer.md) para crear nuevos clientes. En la respuesta, recibirás el `id` del cliente, que usas para crear la sesión de cliente.

Después de crear el cliente, puedes crear la sesión de cliente. Usa el `id` del cliente y el endpoint [Crear sesión de cliente](https://docs.y.uno/reference/customer-sessions-enrollment/create-customer-session.md). El `customer_session` se proporcionará en la respuesta. Necesitas un nuevo `customer_session` cada vez que realices la inscripción de un nuevo método de pago.

En tu servidor, crea también un [objeto de método de pago para inscripción](https://docs.y.uno/reference/payment-methods-checkout/enroll-payment-method-checkout.md) para esa sesión de cliente, a fin de definir qué método de pago puede inscribir el cliente. Mantén tus claves de API privadas en el servidor.

## Paso 4: inicia el proceso de inscripción

Para ofrecer una experiencia de inscripción lite, primero debes inicializar el proceso de inscripción y luego lanzar la interfaz.

### Inicializa la inscripción

Llama a `initEnrollment` en el método `onCreate` de tu activity para preparar el SDK para el flujo de inscripción.

```kotlin theme={"theme":{"light":"github-dark","dark":"github-dark-dimmed"}}
override fun onCreate(savedInstanceState: Bundle?) {
    super.onCreate(savedInstanceState)
    
    initEnrollment { state, message ->
        Log.d("YunoEnrollment", "Enrollment state: $state, error: ${message?.code}")
    }
}
```

### Lanza la interfaz de inscripción

Llama a `startEnrollment` con las sesiones y los parámetros de configuración para mostrar el formulario de inscripción.

```kotlin theme={"theme":{"light":"github-dark","dark":"github-dark-dimmed"}}
startEnrollment(
    customerSession = "CUSTOMER_SESSION",
    countryCode = "US",
    showEnrollmentStatus = true,
)
```

### Parámetros

Configura la inscripción lite con las siguientes opciones:

| Parámetro | Descripción |
| - | - |
| `customerSession` | Hace referencia a la [sesión de cliente](https://docs.y.uno/reference/customer-sessions-enrollment/create-customer-session.md) de la inscripción actual. |
| `countryCode` | Este parámetro especifica el código de país para el que se configura la inscripción. |
| `showEnrollmentStatus` | Controla la visibilidad de la página de carga o spinner de Yuno durante el proceso de inscripción. Por defecto es `true`. |

## Paso 5: estado de la inscripción

Cuando el proceso de inscripción finaliza, el SDK invoca el callback proporcionado en `initEnrollment` con el estado y, en `INTERNAL_ERROR`, un [`StatusMessage`](https://docs.y.uno/es/docs/sdks/resources/references/android#statusmessage-error-details) que describe el fallo (`null` en cualquier otro estado).

### Valores de estado posibles

* `SUCCEEDED`: la inscripción fue exitosa.
* `FAIL`: la inscripción falló.
* `PROCESSING`: la inscripción se está procesando.
* `REJECT`: la inscripción fue rechazada.
* `CANCELED`: el usuario canceló la inscripción.

> [!NOTE]
>
> **App de demostración**
>
> Además de los ejemplos de código proporcionados, puedes acceder al [repositorio del Yuno Android SDK](https://github.com/yuno-payments/yuno-sdk-android) para ver una implementación completa de los SDK de Yuno.

## Manejo de errores

Maneja en tu app los errores devueltos por el SDK, como una inscripción fallida o errores de validación. Para los códigos de estado HTTP y de respuesta, consulta [Códigos de estado y de respuesta](https://docs.y.uno/es/reference/getting-started/response-codes.md) en la referencia de la API.

## Mantente al día

Visita las [notas de la versión](https://docs.y.uno/changelog/android.md) para conocer las últimas actualizaciones del SDK y el historial de versiones.


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