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.
Recursos adicionales
- Consulta Elige la integración adecuada para ti si no tienes claro qué flujo seguir.
- Accede a las Notas de la versión o al repositorio del Yuno Android SDK para verificar la última versión disponible del SDK.
- Inscripción con full-checkout (Android): inscripción automática con componentes de interfaz prediseñados
Requisitos
- Versión mínima del SDK:
minSdkVersion23 o superior (Android 6.0). Obligatoria desde Yuno Android SDK 2.24.0 - Java: Java 8 habilitado
- AndroidX: usa AndroidX en lugar de las bibliotecas de soporte anteriores
- Android Gradle Plugin: 4.0.0 o superior
- ProGuard: 6.2.2 o superior
- Kotlin Gradle Plugin: 1.4.0 o superior
- Compatibilidad con el tamaño de página ELF: cumple los requisitos de alineación de página ELF de 16 KB de Google (listo para Android 15 / ARMv9)
Configuración de ProGuard / R8
Si tu proyecto tieneminifyEnabled = true, agrega estas reglas a tu archivo proguard-rules.pro para que el SDK funcione correctamente, especialmente con el modo completo de R8 de AGP 8.x+.
Reglas oficiales de ProGuard / R8 de Yuno
Reglas oficiales de ProGuard / R8 de Yuno
¿Por qué son necesarias estas reglas?
AGP 8.x+ habilita por defecto el modo completo de R8, que elimina de forma agresiva las firmas de tipos genéricos. Sin-keepattributes Signature, el TypeToken<T> de Gson puede fallar en tiempo de ejecución con java.lang.Class cannot be cast to java.lang.reflect.ParameterizedType.Parámetros
Para ver la lista completa de parámetros, consulta la Referencia común del SDK de Android.Inscripción con full-checkout (Android)
Yuno full-checkout para Android ofrece inscripción con interfaz prediseñada, inscripción de tarjetas, gestión de estados y manejo básico de errores. Consulta la sección anterior de Requisitos.Paso 1: crea un cliente
Crea un cliente en el sistema de Yuno con el endpoint Create customer antes de inscribir métodos de pago. Este endpoint devuelve uncustomer_id. Luego crea una sesión de cliente con el endpoint Create Customer Session; usa el customer_session devuelto al llamar a los métodos de inscripción.
En tu servidor, crea también un objeto de método de pago de inscripción para esa sesión de cliente, a fin de definir qué método de pago puede inscribir el cliente. Mantén tus claves de API privadas en el servidor.
Paso 2: incluye la biblioteca en tu proyecto
Agrega la biblioteca de Yuno a tu proyecto de Android:Agrega el repositorio
Agrega el repositorio Maven de Yuno a la configuración de Gradle de tu proyecto:build.gradle:
Permisos
El Yuno SDK incluye por defecto el permisoINTERNET, necesario para realizar solicitudes de red.
Paso 3: inicializa el SDK con la clave pública
Inicializa el SDK:- Obtén tu clave de API pública en el Yuno Dashboard
- Crea una clase de aplicación personalizada si aún no lo has hecho
- En el método
onCreate()de tu clase de aplicación, llama aYuno.initialize()con tu clave de API:
YunoConfig para personalizar el comportamiento del SDK. Incluye esta configuración al llamar a Yuno.initialize(). Las opciones disponibles son:
Para una explicación detallada del parámetro
keepLoader y del manejo obligatorio de errores, consulta la Guía de referencia de Android.Paso 4: inscribe un nuevo método de pago
El proceso de inscripción es un flujo de dos pasos. Primero, inicializa el proceso para configurar los componentes necesarios. Luego, inicia el flujo de interfaz para que el usuario inscriba un método de pago.4.1 Inicializa el proceso de inscripción
Llama al métodoinitEnrollment dentro del método onCreate de tu activity para preparar tu app y que pueda gestionar el flujo de inscripción. Este es un paso de configuración obligatorio que exige el sistema operativo Android para registrar el contrato que permite al SDK devolver a tu app el estado final de la inscripción.
4.2 Inicia el flujo de inscripción
Llama al métodostartEnrollment para lanzar la interfaz de usuario y comenzar la inscripción de un nuevo método de pago. Puedes llamar a este método en cualquier momento después de ejecutar initEnrollment, por ejemplo, cuando un usuario toca un botón “Enroll New Payment Method”.
startEnrollment: