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.
- Necesitan control total sobre la interfaz y la experiencia de usuario
- Quieren implementar flujos de inscripción personalizados
- Requieren capacidades de integración avanzadas
- Tokenización de tarjetas
- Inscripción segura de métodos de pago
- Acceso directo a la API
- Manejo de errores personalizado
Requisitos
Antes de iniciar la integración del Yuno Android SDK, asegúrate de que tu proyecto cumpla los requisitos técnicos:- 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.Información sobre la versión del SDKVerifica la versión actual del SDK en las Notas de la versión o visitando el repositorio del Yuno Android SDK.
Paso 1: crea un cliente
Crea un cliente con el endpoint Create Customer antes de inscribir métodos de pago.Paso 2: crea una sesión de cliente
Crea un nuevocustomer_session con el endpoint Create Customer Session:
- Incluye el ID del cliente en la solicitud
- Guarda el ID de
customer_sessiondevuelto - Genera un nuevo
customer_sessionpara cada inscripción de método de pago.
Paso 3: agrega el SDK a tu proyecto
- Agrega la fuente del repositorio:
- Agrega la dependencia del SDK:
Se requiere el permiso de InternetEl Yuno SDK incluye automáticamente el permiso
INTERNET, necesario para las solicitudes de red. Asegúrate de que tu AndroidManifest.xml contenga:<uses-permission android:name="android.permission.INTERNET" />Paso 4: inicializa el Headless SDK con la clave pública
Obtén tus claves de API públicas en el Yuno Dashboard. Si no has implementado una aplicación personalizada, crea una. En el métodoonCreate() de tu clase de aplicación, llama a la función de inicialización (Yuno.initialize):
Paso 5: crea un objeto de método de pago de inscripción
Crea un objeto de método de pago de inscripción con el endpoint Enroll Payment Method para configurar la integración del Headless SDK para la inscripción. Al crear este objeto, especifica en qué tipo de método de pago puede inscribirse tu cliente. Actualmente, el Headless SDK solo admite el tipo de método de pago CARD.Verificación de tarjetaPara verificar tarjetas (autorización de valor cero) antes de la inscripción, incluye el objeto
verify al crear el objeto de método de pago para la sesión de cliente.Paso 6: inicia el proceso de inscripción
Usa la funciónapiClientEnroll para iniciar el proceso de inscripción. Esta función requiere parámetros de configuración que definen cómo se procesará la inscripción. La siguiente tabla describe los parámetros obligatorios:
El siguiente bloque de código muestra un ejemplo de la configuración de los parámetros:
Paso 7: genera un vaulted token
Después de recopilar toda la información obligatoria del cliente, crea unvaulted_token con la función apiClientEnroll.continueEnrollment. Como es una función asíncrona, usa un bloque try/catch para gestionar los errores que puedan ocurrir. El siguiente ejemplo muestra cómo crear un vaulted_token:
type en Detail es opcional. Si lo omites, Yuno detecta el tipo de tarjeta a partir del número de tarjeta. Si lo envías, se guarda con la tarjeta y se usa en pagos posteriores, por lo que un tipo incorrecto puede causar rechazos.
La función apiClientEnroll.continueEnrollment es una función suspend. Llámala desde una corrutina (por ejemplo, lifecycleScope.launch). Devuelve un Map<String, Any?> con la respuesta completa. A continuación se muestra un ejemplo de respuesta al llamar a apiClientEnroll.continueEnrollment:
continueEnrollment se declara en el companion object de ApiClientEnroll, por lo que debes importarlo de forma explícita:
Estados del flujo de inscripción
La funciónapiClientEnroll.continueEnrollment devuelve una respuesta que incluye un campo status que indica el estado actual del proceso de inscripción. Estos son los posibles estados devueltos:
Seguimiento del estado mediante webhooksConsidera usar el estado de la inscripción recibido mediante Webhooks. Yuno recomienda basar siempre en este estado las decisiones de negocio en tu plataforma.