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.
Parámetros, personalizaciones y funciones avanzadas para todos los flujos del SDK de Android. Configuración: Flujos de pago (Android), Flujos de inscripción (Android), modos de integració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 datos YunoConfig 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 objeto Yuno 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.0
Cada 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 de returnStatus:

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:
  1. 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 returnStatus se bloquea en tiempo de ejecución con AbstractMethodError en el primer resultado de error, sin ninguna advertencia en tiempo de compilación.
  2. 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.
  3. Agrega el segundo parámetro a cada lambda de callbackEnrollmentState (initEnrollment, startEnrollment, enrollmentStatus, setupEnrollmentInfo): { state -> } pasa a ser { state, message -> }.
  4. Actualiza tus sobrescrituras de returnStatus en YunoPaymentRenderListener y YunoEnrollmentRenderListener a las firmas anteriores.
Leer 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 en YunoConfig. 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ámetro keepLoader 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

  1. Habilita en YunoConfig

  1. Gestiona el OTT y llama a continuePayment

Cuando keepLoader 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:

  1. Gestiona los errores con hideLoader

Si falla la llamada a tu backend y no puedes continuar con continuePayment, llama a hideLoader(). Esto oculta el indicador de carga y finaliza el flujo de pago:
Manejo de fallos
Cuando keepLoader está activo y falla la creación del pago, debes llamar a hideLoader(). De lo contrario, el indicador de carga permanecerá en pantalla indefinidamente (hasta que se active el tiempo de espera integrado).

Compatibilidad

  • Funciona con los flujos de pago Full y Lite (startPayment y startPaymentLite).
  • Compatible con tokens almacenados (vaulted).
  • El indicador de carga respeta el tiempo de espera integrado del SDK. Si no se llama ni a continuePayment ni a hideLoader, 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 pasos startPayment → continuePayment.