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

# SDK nativos de 3DS (iOS)

> Ejecuta desafíos de 3D Secure de forma nativa en tu app iOS con el SDK de 3DS de Netcetera.

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

El Yuno iOS SDK permite ejecutar desafíos de 3D Secure (3DS) de forma nativa dentro de tu app mediante el **SDK de 3DS de Netcetera**. El 3DS nativo ofrece una mejor experiencia de usuario que los desafíos basados en web y algunos adquirentes pueden requerirlo para la autenticación sin fricción.

> [!NOTE]
>
> El 3DS nativo con Netcetera se aplica tanto a los flujos de **pago** como de **inscripción**.

> [!NOTE]
>
> El 3DS nativo es **opcional**: solo necesitas instalar el módulo si tu integración ejecuta desafíos de 3DS dentro de la app. Si no vas a habilitar 3DS, puedes omitir esta guía.

> [!NOTE]
>
> Este es un módulo independiente, por lo que solo lo agregas si necesitas 3DS nativo. Si tu app ya personaliza los estilos del Yuno SDK, esos estilos se propagan automáticamente a la pantalla del desafío, y no necesitas ninguna configuración de interfaz adicional.

Esta guía cubre lo que es específico de Netcetera. La instalación y la activación siguen las mismas reglas que cualquier otro módulo, consulta [Módulos nativos externos (iOS)](https://docs.y.uno/es/docs/sdks/external-native-modules/ios-overview.md).

> [!WARNING]
>
> El paquete independiente anterior, `yuno-3DS-netcetera-iOS`, está obsoleto. Instala el módulo desde el paquete `yuno-sdk-ios` o desde el pod `Yuno3DSNetcetera`, como se describe a continuación.

## Requisitos

* iOS **14.0** o superior.
* **YunoSDK 2.25.0 o superior** ya instalado en tu app.
* El módulo `Yuno3DSNetcetera`, versión **3.0.0 o superior**, instalado mediante Swift Package Manager o CocoaPods (consulta más abajo).

## Instalación

> [tab] Swift Package Manager
>
> El módulo se distribuye en el mismo paquete que el Yuno SDK. En Xcode ve a **File > Add Package Dependencies...** y agrega:
>
> ```
> https://github.com/yuno-payments/yuno-sdk-ios
> ```
>
> elige **Up to Next Major Version** desde `2.25.0` y marca el producto `Yuno3DSNetcetera` junto a `YunoSDK`. El binario `ThreeDS_SDK` de Netcetera se resuelve automáticamente desde el repositorio de Netcetera.

> [tab] CocoaPods
>
> Agrega lo siguiente a tu `Podfile`:
>
> ```ruby theme={"theme":{"light":"github-dark","dark":"github-dark-dimmed"}}
> platform :ios, '14.0'
>
> target 'YourApp' do
>   use_frameworks!
>
>   pod 'YunoSDK',          '~> 2.25'
>   pod 'Yuno3DSNetcetera', '~> 3.0'
> end
> ```
>
> Luego ejecuta:
>
> ```bash theme={"theme":{"light":"github-dark","dark":"github-dark-dimmed"}}
> pod install
> ```

## Activación del proveedor de 3DS

> [tab] Swift Package Manager
>
> El proveedor se **registra automáticamente** cuando se carga el framework. No se requiere código adicional:
>
> ```swift theme={"theme":{"light":"github-dark","dark":"github-dark-dimmed"}}
> import YunoSDK
>
> Yuno.initialize(apiKey: "YOUR_API_KEY", config: YunoConfig())
> ```

> [tab] CocoaPods
>
> La compilación de CocoaPods se distribuye como un framework **estático**, por lo que no se registra automáticamente. Llama a `Yuno3DSNetcetera.register()` **una sola vez**, antes de `Yuno.initialize(...)`:
>
> ```swift theme={"theme":{"light":"github-dark","dark":"github-dark-dimmed"}}
> import YunoSDK
> import Yuno3DSNetcetera
>
> Yuno3DSNetcetera.register()
> Yuno.initialize(apiKey: "YOUR_API_KEY", config: YunoConfig())
> ```

> [!TIP]
>
> Una vez registrado, YunoSDK enruta automáticamente cualquier desafío de 3DS a través del proveedor Netcetera. **No necesitas cambiar nada de tu código de pago ni de inscripción.**

## Certificado de sandbox

Al probar contra el entorno sandbox de Yuno, el SDK de Netcetera requiere que un certificado raíz de prueba de Visa (`acq-root-certeq-prev-environment.crt`) esté presente en el bundle principal de tu app.

> [!NOTE]
>
> **Contacta a tu TAM (Technical Account Manager) de Yuno para obtener el certificado.** No se distribuye públicamente.

Una vez que tengas el archivo:

**1. Agrégalo a Xcode**

Arrástralo al Project Navigator de Xcode, dentro del grupo de tu target de app.

**2. Selecciona el target**

Marca **Add to targets** y selecciona tu target de app.

**3. Verifica los recursos del bundle**

Verifica que aparezca en **Target → Build Phases → Copy Bundle Resources**.

> [!NOTE]
>
> En entornos de producción este certificado no se usa y puede omitirse de las compilaciones Release.

## Solución de problemas

> [accordion] Error del linker que menciona YunoThreeDSRegistry
>
> Tu `YunoSDK` es anterior a la versión que requiere este módulo. Actualízalo a `>= 2.25.0`.

> [accordion] La interfaz del desafío de 3DS nunca aparece (CocoaPods)
>
> Olvidaste llamar a `Yuno3DSNetcetera.register()` antes de `Yuno.initialize(...)`.

> [accordion] Consola: acq-root-certeq-prev-environment.crt not found
>
> Solo es relevante en sandbox. Agrega el certificado al bundle de tu app (consulta [Certificado de sandbox](#sandbox-certificate)). Puedes ignorarlo sin problema en producción.


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