Saltar al contenido principal
Esta página documenta un SDK heredado. ¿Vas a iniciar una nueva integración? Usa el Yuno SDK. ¿Ya usas un SDK heredado? Sigue la guía de migración.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.
El 3DS nativo con Netcetera se aplica tanto a los flujos de pago como de inscripción.
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.
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).
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

El módulo se distribuye en el mismo paquete que el Yuno SDK. En Xcode ve a File > Add Package Dependencies… y agrega:
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.

Activación del proveedor de 3DS

El proveedor se registra automáticamente cuando se carga el framework. No se requiere código adicional:
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.
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.
En entornos de producción este certificado no se usa y puede omitirse de las compilaciones Release.

Solución de problemas

Tu YunoSDK es anterior a la versión que requiere este módulo. Actualízalo a >= 2.25.0.
Olvidaste llamar a Yuno3DSNetcetera.register() antes de Yuno.initialize(...).
Solo es relevante en sandbox. Agrega el certificado al bundle de tu app (consulta Certificado de sandbox). Puedes ignorarlo sin problema en producción.