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.
Esta página es una guía del Yuno Lite SDK para pagos en Android. Este SDK ofrece un proceso de integración simplificado con las capacidades esenciales de pago, lo que lo hace ideal para comercios que:
  • Necesitan una implementación rápida con requisitos mínimos de personalización
  • Quieren centrarse principalmente en el procesamiento de pagos con tarjeta
  • Prefieren una interfaz lista para usar que gestione el flujo de pago
El Lite SDK incluye funciones principales como:
  • Componentes de interfaz de pago predefinidos
  • Procesamiento de pagos con tarjeta
  • Gestión básica del estado del pago
  • Manejo esencial de errores
Para los comercios que requieren funciones más avanzadas, como varios métodos de pago, una interfaz personalizada o prevención de fraude avanzada, considera usar el Full SDK de Yuno.

Requisitos

Antes de comenzar la integración del Yuno Android SDK, asegúrate de que tu proyecto cumpla los requisitos técnicos. Además, asegúrate de contar con los siguientes prerrequisitos:
  • Debes tener una cuenta activa de Yuno.
  • Necesitas tus credenciales de la API de Yuno (account_id, public-api-key y private-secret-key), que puedes obtener en la sección de credenciales de Developers del Dashboard de Yuno.

Paso 1: crea un cliente

Crea un cliente con el endpoint Create customer antes de iniciar los pagos. El ID de cliente que devuelve este endpoint se usará al crear la checkout_session.

Paso 2: crea una sesión de checkout

Crea una nueva checkout_session con el endpoint Create checkout session para inicializar el flujo de pago.

Paso 3: incluye la biblioteca en tu proyecto

Incluye el archivo del Yuno SDK en tu proyecto mediante Gradle. Agrega el origen del repositorio:
Incluye el siguiente código en el archivo build.gradle para agregar la dependencia del Yuno SDK:

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

Inicializa el SDK llamando a Yuno.initialize() en el método onCreate() de tu aplicación:

Personalización de YunoConfig

Paso 5: inicia el proceso de checkout

Llama al método startCheckout en tu activity:

Estados del callback

Paso 6: inicia el proceso de pago

Llama a startPaymentLite para iniciar el proceso:

Paso 7: crea el pago

Después de obtener el token de un solo uso (OTT), crea el pago desde tu backend con la API Create Payment.

Paso 8: continúa el pago (obligatorio)

Si la respuesta de la API incluye sdk_action_required: true, llama a continuePayment():
Demo AppConsulta el repositorio del Yuno Android SDK para ver ejemplos completos de implementación.