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.
Modifica los estilos del Yuno Android SDK (colores, texto, botones) para alinear los formularios de pago y el checkout con tu marca. La estructura de los elementos se mantiene uniforme. Para ver todos los parámetros y opciones de configuración del SDK de Android, consulta la Referencia común del SDK de Android.

Pautas generales

La forma de personalizar el SDK de Android depende de su versión:
  • SDK 2.x: aplica estilos al SDK con Compose, pasando YunoStyles en YunoConfig al inicializar. Consulta Estilos con Compose.
  • SDK 1.x: el SDK admite temas y estilos XML, definidos dentro de los estilos de tu aplicación. Consulta Elementos personalizables.
  • Yuno SDK (Android v3.x): YunoStyles se reemplaza por Appearance, que se define por transacción. Consulta Estilos.

Estilos con Compose (SDK 2.x)

En el SDK 2.x los formularios de checkout ya no usan vistas XML ni temas por pantalla. Pasa un objeto YunoStyles en YunoConfig cuando inicialices el SDK. Una sola configuración cubre todas las pantallas. YunoStyles tiene estos campos: YunoButtonStyles tiene estos campos. Todos son opcionales: Ejemplo:

Elementos personalizables

Esta sección aplica al SDK 1.x. Para el SDK 2.x, usa Estilos con Compose.
Elementos que puedes modificar para lograr un estilo personalizado. Algunas personalizaciones requieren la versión 1.13.0 o superior.

Estilos de fuente

Puedes reemplazar las fuentes del Yuno Android SDK si quieres usar tu propia familia de fuentes. Puedes reemplazar los siguientes estilos de fuente:
  • YunoRegularFont
  • YunoMediumFont
  • YunoBoldFont
Ejemplo (estilo de fuente):

Estilos de botón

Reemplaza los estilos de botón; las opciones disponibles dependen de la versión del SDK. Botones que puedes personalizar: Para cada estilo, puedes definir los siguientes atributos:
Ejemplo (Button.Normal.NeutralB y fuente del botón):

Estilos de color

Reemplaza los estilos de color para personalizar el SDK; las opciones dependen de la versión del SDK. Estilos de color por versión: Ejemplo (colores, SDK v1.13.0+):

Estilos de texto

Puedes reemplazar los estilos de texto del Yuno Android SDK para personalizar la apariencia del SDK.
Esta función solo está disponible para la versión 1.13.0 o superior del SDK.
Atributos personalizables por estilo de texto: Ejemplo (personalizaciones de texto):

Crea tu propio flujo de formulario de tarjeta

Esta sección aplica al SDK 1.x. Las vistas XML que describe no forman parte del SDK 2.x.
El primer paso para crear tu flujo de formulario de tarjeta es crear un nuevo archivo de recursos de diseño llamado screen_payment_card_form.xml para reemplazar el XML actual e implementar tu diseño. Después de crear el archivo screen_payment_card_form.xml, puedes definir tu propio diseño. Debes usar los componentes de campos seguros de Yuno, lo que garantiza que el Yuno SDK pueda obtener la información de la tarjeta de crédito durante el checkout. A continuación, encontrarás una lista de todos los componentes que puedes usar para cambiar el diseño:
Cambio de componentesAl cambiar los componentes del Yuno Android SDK, debes usarlos con su id de Android definido.

v1.10.0 o superior

Hay componentes adicionales disponibles para la versión v1.10.0 o superior del Yuno SDK. Estos componentes se enumeran en la subsección siguiente.
  • CloseButton: botón para cerrar el formulario.
  • CardNumberEditText: campo donde el usuario puede ingresar el número de la tarjeta de crédito.
  • CardDataStackView: campo donde el usuario puede ingresar la fecha de vencimiento y el código de verificación (CVV/CVC) de la tarjeta de crédito.
  • TextView para el tipo de tarjeta Voucher: es un texto que el Yuno SDK muestra cuando la tarjeta es de tipo VOUCHER , debes colocarlo debajo del campo CVV.
  • TextFieldItemView para el nombre del titular de la tarjeta: campo donde el usuario puede ingresar el nombre del titular de la tarjeta de crédito.
  • SpinnerFieldItemView para el tipo de documento de identificación: un selector donde el titular de la tarjeta de crédito puede elegir su tipo de documento de identificación.
  • TextFieldItemView para el número de documento de identificación: campo donde el usuario puede ingresar el número de documento de identificación del titular de la tarjeta de crédito.
  • PhoneInformationView para el número de teléfono del cliente: campo donde el usuario puede ingresar su número de teléfono si es necesario. Además de proporcionar el id de Android, debe tener visibilidad gone.
  • Installments: componente que muestra el selector de cuotas de la tarjeta. Además de proporcionar el id de Android, debe tener visibilidad gone y debes agregar la dependencia ShimmerFrameLayout: implementation 'com.facebook.shimmer:shimmer:0.5.0'.
  • TextView de Yuno: un texto que indica que Yuno verificó el formulario.
  • CustomYunoSwitch: es un componente de interruptor que permite al usuario elegir si la tarjeta se usará como crédito o débito. Además de proporcionar el id de Android, debe tener visibilidad gone.
  • CustomYunoSwitch: una información sobre herramientas (tooltip) que muestra cómo funciona el interruptor. Además de proporcionar el id de Android, debe tener visibilidad gone. Yuno recomienda colocar este componente junto al interruptor.
  • AppCompatCheckBox: una casilla de verificación que los usuarios pueden usar para elegir si quieren guardar la tarjeta de crédito para compras futuras.
  • Button: valida el formulario de tarjeta y continúa el proceso de pago. Cuando el usuario hace clic en este botón, el SDK envía el formulario y manda la información de la tarjeta de crédito a Yuno.

Componentes disponibles para v1.10.0 y superior

Disponibles solo para el SDK v1.10.0 o superior.
  • TextFieldItemView para la dirección del cliente: se usa para ingresar la dirección del cliente cuando es necesaria. Asegúrate de usarlo con su id de Android especificado (@+id/textField_address) y de que tenga visibilidad gone de forma predeterminada.
  • TextFieldItemView para el estado del cliente: permite al cliente ingresar su estado si es necesario. Debe usarse con el id de Android definido (@+id/textField_state) y debe tener gone como visibilidad predeterminada.
  • TextFieldItemView para la ciudad del cliente: está pensado para ingresar la ciudad del cliente. Debe usarse con el id de Android proporcionado (@+id/textField_city) y mantener gone como configuración de visibilidad predeterminada.
  • TextFieldItemView para el código postal del cliente: aquí el cliente puede ingresar su código postal. Asegúrate de implementarlo con el id de Android especificado (@+id/textField_zip_cod) y de que tenga visibilidad gone de forma predeterminada:
  • SpinnerFieldItemView para el país del cliente: este SpinnerFieldItemView selecciona el país del cliente cuando es necesario. Debe usarse con el id de Android definido (@+id/spinner_country) y debe tener visibilidad gone de forma predeterminada.
  • SpinnerFieldItemView para el género del cliente: se usa para seleccionar el género del cliente si es necesario. Asegúrate de usarlo con su id de Android definido (@+id/spinner_gender) y de que tenga visibilidad gone de forma predeterminada.

Autocompletado de direcciones

Los comercios pueden activar o desactivar la función de autocompletado de direcciones en el SDK de Android. Cuando está activada, el SDK completa automáticamente los campos de dirección a partir de la búsqueda por código postal. Cuando está desactivada, los usuarios deben ingresar manualmente toda la información de la dirección.