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.
Parámetros clave (creación de la sesión de checkout)
Al crear una sesión de checkout en tu backend para los flujos de pago, los siguientes parámetros se usan con frecuencia en los SDK de Android:Parámetros de pago (referencia completa)
Parámetros para los flujos de pago. Todos los parámetros usados en Flujos de pago (Android) se enumeran aquí con todo detalle.Opciones de YunoConfig (inicialización)
El comportamiento en tiempo de ejecución y la apariencia se configuran mediante la clase de datosYunoConfig al llamar a Yuno.initialize(context, apiKey, config). A continuación se enumeran todos los parámetros usados en los flujos de pago e inscripción de Android. Para el estilo visual (fuentes, colores, botones), consulta Personalizaciones del SDK (Android).
Parámetros de inscripción (referencia completa)
Parámetros para los flujos de inscripción. Todos los parámetros usados en Flujos de inscripción (Android) se enumeran aquí con todo detalle.Métodos públicos
Los siguientes métodos están disponibles globalmente mediante el objetoYuno o como extensiones de Activity.
Activity.hideLoader()
Oculta el indicador de carga del SDK cuando keepLoader está activo. Usa este método cuando falle la creación del pago en tu backend. También es útil cuando no puedes continuar con continuePayment().
Yuno.continuePayment()
Reanuda el flujo de pago para los métodos asíncronos (3ds, PIX, etc.) después de que se haya creado un pago en tu backend.
StatusMessage (detalles del error)
Disponible desde el SDK de Android v2.22.0Cada callback de resultado de pago e inscripción, y el
returnStatus de los listeners de render, incluye un StatusMessage? junto al estado. Distingue un rechazo del backend de un fallo interno del SDK y te da un código sobre el cual actuar, en lugar de una cadena de estado plana.
Cuándo se completa:
Integración con render
Si integras mediante la API de render, el mismo valor llega a tus listeners como el último parámetro dereturnStatus:
Migración a 2.22.0
StatusMessage es un cambio incompatible: el SDK no incluye sobrecargas obsoletas de las firmas anteriores. Cuando actualices desde 2.21.x o una versión anterior:
- Recompila tu app con el nuevo SDK. Agregar el nuevo AAR a una app compilada con una versión anterior no es seguro: un listener de render compilado con la firma anterior de
returnStatusse bloquea en tiempo de ejecución conAbstractMethodErroren el primer resultado de error, sin ninguna advertencia en tiempo de compilación. - Agrega el tercer parámetro a cada lambda de
callbackPaymentState(startCheckout,startPayment,startPaymentLite,startPaymentSeamlessLite,continuePayment,continueCardPayment):{ state, subState -> }pasa a ser{ state, subState, message -> }. Las lambdas de Kotlin deben coincidir en aridad, por lo que la forma anterior no compila. - Agrega el segundo parámetro a cada lambda de
callbackEnrollmentState(initEnrollment,startEnrollment,enrollmentStatus,setupEnrollmentInfo):{ state -> }pasa a ser{ state, message -> }. - Actualiza tus sobrescrituras de
returnStatusenYunoPaymentRenderListeneryYunoEnrollmentRenderListenera las firmas anteriores.
message es opcional: si ignoras el nuevo parámetro, tu lógica existente sigue funcionando. Notas de la versión: Changelog de Android.
Inscripción de métodos de pago
Puedes inscribir métodos de pago (almacenar tarjetas para uso futuro) durante el flujo de pago o mediante flujos de inscripción dedicados. Para los flujos de pago, habilita el guardado de tarjetas enYunoConfig. Además, configura payment_method.vault_on_success (o equivalente) al crear la sesión de checkout, donde sea compatible. Para la inscripción dedicada, consulta Flujos de inscripción (Android).
Parámetro keepLoader
Disponible desde el SDK de Android v2.13.0
Cómo funciona
El parámetrokeepLoader te permite mantener el indicador de carga del SDK a lo largo de todo el flujo startPayment → continuePayment. Esto evita que el indicador parpadee entre los pasos.
De forma predeterminada, el SDK oculta su indicador de carga después de generar el token de un solo uso (OTT). Vuelve a mostrarlo cuando se llama a continuePayment. Con keepLoader habilitado, el indicador permanece visible de forma continua desde que el usuario envía el formulario de pago hasta que el pago se procesa por completo (o se oculta explícitamente).
Integración
- Habilita en YunoConfig
- Gestiona el OTT y llama a
continuePayment
Cuando continuePaymentkeepLoader está habilitado, el callback del OTT se activa mientras el indicador de carga sigue visible. Crea tu pago en tu backend y luego llama a continuePayment como de costumbre:
- Gestiona los errores con
hideLoader
Si falla la llamada a tu backend y no puedes continuar con hideLoadercontinuePayment, llama a hideLoader(). Esto oculta el indicador de carga y finaliza el flujo de pago:
Compatibilidad
- Funciona con los flujos de pago Full y Lite (
startPaymentystartPaymentLite). - Compatible con tokens almacenados (vaulted).
- El indicador de carga respeta el tiempo de espera integrado del SDK. Si no se llama ni a
continuePaymentni ahideLoader, el indicador se ocultará automáticamente después del período de espera. - No aplica al flujo Seamless (
startPaymentSeamlessLite). Este flujo no usa el patrón de dos pasosstartPayment→continuePayment.