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 Android SDK permite ejecutar desafíos de 3D Secure (3DS) de forma nativa dentro de tu app usando el SDK de 3DS de Netcetera. El 3DS nativo ofrece una UX más fluida que la alternativa basada en WebView (sin salto a un navegador dentro de la app) y algunos adquirentes pueden exigirlo para la autenticación sin fricción.
El 3DS nativo con Netcetera aplica tanto a los flujos de pago como de inscripción (la inscripción desde el Yuno Android SDK 2.22.0).
El 3DS nativo es opcional: solo necesitas instalar el módulo del proveedor 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 (de aproximadamente 3-4 MB), 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, no se necesita ninguna configuración adicional de UI.
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 External Native Modules (Android).

Requisitos

  • Android 6.0 (API level 23) o superior, el mínimo del Yuno Android SDK desde la versión 2.24.0.
  • Yuno Payments SDK 2.16.0 o superior ya instalado en tu app (com.yuno.payments:android-sdk).
  • El módulo del proveedor de 3DS de Netcetera (com.yuno.payments:yuno-sdk-3ds-netcetera), instalado mediante Gradle (consulta más abajo).

Compatibilidad

Cada versión de este módulo se compila y se prueba contra una versión mínima del Yuno Payments SDK. El POM del módulo no fija una versión específica del núcleo. Las versiones inferiores al mínimo pueden no exponer las API en las que se apoya este módulo y pueden fallar en tiempo de ejecución con NoSuchMethodError / NoSuchFieldError. Al actualizar cualquiera de las dos dependencias, actualiza ambas a la vez para que la combinación se mantenga dentro de un par compatible.

Paso 1: declara el repositorio Maven de Netcetera

El SDK de 3DS de Netcetera está alojado en el servidor Maven público de Netcetera. Como Gradle no propaga repositorios transitivos a través de los metadatos del POM, tu app debe declarar el repositorio explícitamente para poder resolver la dependencia del SDK de Netcetera. Agrega la entrada al archivo de configuración de tu proyecto dentro de dependencyResolutionManagement.repositories:
En settings.gradle:
Es posible que todavía uses el bloque heredado allprojects { repositories { … } } en el build.gradle de tu raíz. Si es así, agrega allí la misma línea maven { url "…" } de Netcetera.

Paso 2: agrega la dependencia

Agrega la dependencia de Yuno 3DS Netcetera al archivo de compilación del módulo de tu app:
En build.gradle:
El SDK de 3DS de Netcetera original que envuelve yuno-sdk-3ds-netcetera y su dependencia requerida androidx.startup se incorporan de forma transitiva. No necesitas declararlas tú mismo.

Activar el proveedor de 3DS

El módulo se registra automáticamente en el Yuno Payments SDK cuando se inicia el proceso de tu app (mediante Jetpack App Startup). No se requiere código adicional: solo inicializa el Yuno SDK como de costumbre:
Una vez registrado, el Yuno Payments SDK enruta automáticamente cualquier desafío de 3DS durante el checkout o la inscripción a través del proveedor Netcetera.

Permisos

android.permission.INTERNET se declara en el manifiesto del módulo y se fusiona automáticamente en tu app. No se requiere ninguna acción.

Certificado de sandbox

Al probar contra el entorno sandbox de Yuno, el SDK de Netcetera requiere que haya un certificado de esquema de tarjeta en tu app.
Contacta a tu TAM (Technical Account Manager) de Yuno para obtener el certificado. No se distribuye públicamente.
Esto solo se requiere para las pruebas en sandbox, no para producción.