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.
Paso 1: incluye la biblioteca en tu proyecto
Antes de continuar con la implementación del Lite SDK, consulta la Guía de inicio rápido para ver las instrucciones detalladas sobre cómo integrar correctamente el SDK en tu proyecto. Elige el método de integración que mejor se adapte a tu flujo de desarrollo y a tus requisitos técnicos. Después de completar la integración del SDK, puedes continuar con los siguientes pasos para implementar la funcionalidad de inscripción lite.Paso 2: inicializa el SDK
Inicializa el Yuno SDK en tu claseApplication proporcionando un PUBLIC_API_KEY válido:
CredencialesConsulta la página de credenciales para obtener más información: /reference/getting-started/authentication
Paso 3: crea una sesión de cliente
Para iniciar el proceso de inscripción, debes proporcionar elcustomer_session. Primero, debes crear un cliente. Usa el endpoint Crear cliente para crear nuevos clientes. En la respuesta, recibirás el id del cliente, que usas para crear la sesión de cliente.
Después de crear el cliente, puedes crear la sesión de cliente. Usa el id del cliente y el endpoint Crear sesión de cliente. El customer_session se proporcionará en la respuesta. Necesitas un nuevo customer_session cada vez que realices la inscripción de un nuevo método de pago.
En tu servidor, crea también un objeto de método de pago para 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 4: inicia el proceso de inscripción
Para ofrecer una experiencia de inscripción lite, primero debes inicializar el proceso de inscripción y luego lanzar la interfaz.
- Inicializa la inscripción
Llama a initEnrollment en el método onCreate de tu activity para preparar el SDK para el flujo de inscripción.
- Lanza la interfaz de inscripción
Llama a startEnrollment con las sesiones y los parámetros de configuración para mostrar el formulario de inscripción.
Parámetros
Configura la inscripción lite con las siguientes opciones:Paso 5: estado de la inscripción
Cuando el proceso de inscripción finaliza, el SDK invoca el callback proporcionado eninitEnrollment con el estado y, en INTERNAL_ERROR, un StatusMessage que describe el fallo (null en cualquier otro estado).
Valores de estado posibles
SUCCEEDED: la inscripción fue exitosa.FAIL: la inscripción falló.PROCESSING: la inscripción se está procesando.REJECT: la inscripción fue rechazada.CANCELED: el usuario canceló la inscripción.
App de demostraciónAdemás de los ejemplos de código proporcionados, puedes acceder al repositorio del Yuno Android SDK para ver una implementación completa de los SDK de Yuno.