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 SDK de Android facilita la implementación de flujos de inscripción para guardar métodos de pago en la cuenta de un cliente. Incluye la biblioteca en tu proyecto siguiendo los mismos pasos que en full-checkout.

Recursos adicionales

Requisitos

  • Versión mínima del SDK: minSdkVersion 23 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 tiene minifyEnabled = 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+.

¿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 un customer_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:
Agrega la dependencia en build.gradle:

Permisos

El Yuno SDK incluye por defecto el permiso INTERNET, necesario para realizar solicitudes de red.

Paso 3: inicializa el SDK con la clave pública

Inicializa el SDK:
  1. Obtén tu clave de API pública en el Yuno Dashboard
  2. Crea una clase de aplicación personalizada si aún no lo has hecho
  3. En el método onCreate() de tu clase de aplicación, llama a Yuno.initialize() con tu clave de API:
Usa la data class 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.
cardFlow eliminado de YunoConfigA partir de la versión 2.11.0, cardFlow ya no forma parte de YunoConfig. La configuración del flujo de tarjeta ahora se gestiona exclusivamente a través del CheckoutBuilder.

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étodo initEnrollment 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étodo startEnrollment 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”.
Parámetros de startEnrollment:

Referencia común

Para ver todos los detalles de parámetros y personalización, consulta la Referencia común del SDK de Android.