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

> Inscribe métodos de pago con el Lite SDK en iOS mediante el flujo del delegate de inscripción

> [!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 capacidad de inscripción del Lite SDK de iOS de Yuno 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. Es compatible con CocoaPods y Swift Package Manager.

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 capacidad de inscripción del Lite SDK.

## Paso 2: inicializa el SDK

Inicializa el Yuno SDK en tu `AppDelegate` (o en la estructura `App` para SwiftUI) proporcionando una `PUBLIC_API_KEY` válida:

```swift theme={"theme":{"light":"github-dark","dark":"github-dark-dimmed"}}
import UIKit
import YunoSDK

@main
class AppDelegate: UIResponder, UIApplicationDelegate {
    func application(_ application: UIApplication, didFinishLaunchingWithOptions launchOptions: [UIApplication.LaunchOptionsKey: Any]?) -> Bool {
        Yuno.initialize(
            apiKey: "YOUR_PUBLIC_API_KEY",
            config: YunoConfig()
        )
        return true
    }
}
```

> [!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 [Create Customer](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 [Create Customer Session](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 inscribas un nuevo método de pago.

## Paso 4: adopta YunoEnrollmentDelegate

Para gestionar el proceso de inscripción, tu clase (normalmente un `UIViewController`) debe adoptar el protocolo `YunoEnrollmentDelegate`.

> [!NOTE]
>
> **Requisitos de concurrencia de Swift 6**
>
> Si usas Swift 6, deberás implementar el protocolo `YunoEnrollmentDelegate` teniendo en cuenta consideraciones específicas de concurrencia. Consulta la guía [Swift 6 Concurrency](https://docs.y.uno/es/docs/sdks/resources/swift-6-concurrency.md) para ver las opciones de implementación detalladas y las mejores prácticas.

```swift theme={"theme":{"light":"github-dark","dark":"github-dark-dimmed"}}
class EnrollmentViewController: UIViewController, @preconcurrency YunoEnrollmentDelegate {
    // Required delegate properties
    var customerSession: String { "CUSTOMER_SESSION" }
    var countryCode: String { "US" }
    var viewController: UIViewController? { self }

    func yunoEnrollmentResult(_ result: Yuno.Result) {
        switch result.status {
        case .succeeded:
            print("Enrollment succeeded!")
        case .fail:
            print("Enrollment failed")
        case .reject:
            print("Enrollment rejected")
        case .processing:
            print("Enrollment processing")
        case .internalError:
            print("Internal error")
        case .userCancelled:
            print("User canceled")
        @unknown default:
            break
        }
    }
}
```

### Propiedades del delegate

| Propiedad | 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. |
| `viewController` | El view controller desde el cual se presentará la interfaz de inscripción. |

## Paso 5: inicia el flujo de inscripción

Una vez que hayas implementado el delegate, llama a `enrollPayment` para iniciar la interfaz de inscripción:

```swift theme={"theme":{"light":"github-dark","dark":"github-dark-dimmed"}}
Yuno.enrollPayment(with: self, showPaymentStatus: true)
```

### Parámetros

| Parámetro | Descripción |
| - | - |
| `with` | El objeto que implementa `YunoEnrollmentDelegate`. |
| `showPaymentStatus` | Controla si el SDK muestra sus propias pantallas de estado después del proceso de inscripción. |

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

## Gestión de errores

Gestiona en tu app los errores que devuelve el SDK, como errores de inscripción fallida o de validación. Para conocer 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/ios.md) para ver 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.