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.
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
YunoStylesenYunoConfigal 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):
YunoStylesse reemplaza porAppearance, 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 objetoYunoStyles 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.
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:YunoRegularFontYunoMediumFontYunoBoldFont
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:
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.
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:
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.
TextViewpara el tipo de tarjeta Voucher: es un texto que el Yuno SDK muestra cuando la tarjeta es de tipoVOUCHER, debes colocarlo debajo del campo CVV.
TextFieldItemViewpara el nombre del titular de la tarjeta: campo donde el usuario puede ingresar el nombre del titular de la tarjeta de crédito.
SpinnerFieldItemViewpara 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.
TextFieldItemViewpara 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.
PhoneInformationViewpara 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 elidde Android, debe tener visibilidadgone.
Installments: componente que muestra el selector de cuotas de la tarjeta. Además de proporcionar elidde Android, debe tener visibilidadgoney debes agregar la dependenciaShimmerFrameLayout:implementation 'com.facebook.shimmer:shimmer:0.5.0'.
TextViewde 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 elidde Android, debe tener visibilidadgone.
CustomYunoSwitch: una información sobre herramientas (tooltip) que muestra cómo funciona el interruptor. Además de proporcionar elidde Android, debe tener visibilidadgone. 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.TextFieldItemViewpara la dirección del cliente: se usa para ingresar la dirección del cliente cuando es necesaria. Asegúrate de usarlo con suidde Android especificado (@+id/textField_address) y de que tenga visibilidadgonede forma predeterminada.
TextFieldItemViewpara el estado del cliente: permite al cliente ingresar su estado si es necesario. Debe usarse con elidde Android definido (@+id/textField_state) y debe tenergonecomo visibilidad predeterminada.
TextFieldItemViewpara la ciudad del cliente: está pensado para ingresar la ciudad del cliente. Debe usarse con elidde Android proporcionado (@+id/textField_city) y mantenergonecomo configuración de visibilidad predeterminada.
TextFieldItemViewpara el código postal del cliente: aquí el cliente puede ingresar su código postal. Asegúrate de implementarlo con elidde Android especificado (@+id/textField_zip_cod) y de que tenga visibilidadgonede forma predeterminada:
SpinnerFieldItemViewpara el país del cliente: este SpinnerFieldItemView selecciona el país del cliente cuando es necesario. Debe usarse con elidde Android definido (@+id/spinner_country) y debe tener visibilidadgonede forma predeterminada.
SpinnerFieldItemViewpara el género del cliente: se usa para seleccionar el género del cliente si es necesario. Asegúrate de usarlo con suidde Android definido (@+id/spinner_gender) y de que tenga visibilidadgonede forma predeterminada.