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 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.
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 conNoSuchMethodError / 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 dedependencyResolutionManagement.repositories:
- Groovy DSL
- Kotlin DSL
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:- Groovy DSL
- Kotlin DSL
En
build.gradle: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: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.