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.
Orientación: elige tu flujo de integración. Antes de comenzar, revisa el flujo de integración oficial.
  • Flujo estándar (Full Checkout): Recomendado para la mayoría de los comercios. Yuno se encarga de la interfaz, la seguridad y las actualizaciones automáticas de los métodos de pago.
  • Flujo personalizado (este SDK): Úsalo solo si necesitas control total sobre la experiencia de usuario. Nota: Serás responsable de gestionar manualmente los estados de los pagos, las transiciones de 3DS y la recopilación de datos para el enrutamiento de fraude.
Sigue esta guía paso a paso para implementar y habilitar la función de inscripción del Lite SDK de Yuno para Android en tu app.

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 clase Application 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 el customer_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.

  1. 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.

  1. 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 en initEnrollment 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.

Manejo de errores

Maneja en tu app los errores devueltos por el SDK, como una inscripción fallida o errores de validación. Para los códigos de estado HTTP y de respuesta, consulta Códigos de estado y de respuesta en la referencia de la API.

Mantente al día

Visita las notas de la versión para conocer las últimas actualizaciones del SDK y el historial de versiones.