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 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
- Componentes de interfaz de pago predefinidos
- Procesamiento de pagos con tarjeta
- Gestión básica del estado del pago
- Manejo esencial de errores
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-keyyprivate-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 lacheckout_session.
Paso 2: crea una sesión de checkout
Crea una nuevacheckout_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:build.gradle para agregar la dependencia del Yuno SDK:
Paso 4: inicializa el SDK con la clave pública
Inicializa el SDK llamando aYuno.initialize() en el método onCreate() de tu aplicación:
Personalización de YunoConfig
Paso 5: inicia el proceso de checkout
Llama al métodostartCheckout en tu activity:
Estados del callback
Paso 6: inicia el proceso de pago
Llama astartPaymentLite 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 incluyesdk_action_required: true, llama a continuePayment():
Demo AppConsulta el repositorio del Yuno Android SDK para ver ejemplos completos de implementación.