Saltar al contenido principal
Adapta las vistas integradas del SDK a tu marca.
Hay dos formas de dar estilo al SDK:
  • En código (iOS, Android y React Native): pasa un objeto Appearance en TransactionConfig (se explica más abajo). Web no tiene la opción appearance. Consulta la pestaña Web para ver qué estilizas en código.
  • Desde el Checkout Builder: configura los estilos del lado del servidor en tu Yuno Dashboard, sin necesidad de código.
Si no configuras ninguno, el SDK usa sus estilos predeterminados.
El SDK Web se renderiza en tu página como DOM normal, por lo que le das estilo con CSS y algunos campos de configuración. En Web no existe un objeto appearance.

Qué puedes estilizar

Clases CSS

Cada elemento que el SDK renderiza en tu página lleva una clase con el prefijo sdk-payments-. Apúntalas desde tu hoja de estilos para personalizar colores, espaciado, bordes y otras propiedades visuales. Las clases más comunes incluyen:
Las clases CSS pueden cambiar entre versiones del SDK. Inspecciona el DOM renderizado en las herramientas para desarrolladores de tu navegador para encontrar los nombres de clase vigentes.

Estilos de los iframes de tarjeta

El número de tarjeta, la fecha de vencimiento y el CVV se renderizan dentro de iframes por cumplimiento de PCI. El CSS de tu página no puede llegar a ellos. Usa card.styles para inyectar CSS y card.fonts para cargar fuentes personalizadas dentro de los iframes.

Fuentes personalizadas

card.fonts carga archivos de fuente dentro de los iframes de tarjeta. No los aplica: haz referencia a la familia por su nombre en card.styles, como en el ejemplo anterior.
Los iframes cargan los archivos desde un origen distinto al de tu página, por lo que el host de la fuente debe permitir solicitudes de origen cruzado (enviar un encabezado Access-Control-Allow-Origin). Si un archivo no se carga, el campo recurre a la siguiente fuente de tu lista font-family.

Tipos de diseño de campos

El campo inputDesignType controla cómo se muestran las etiquetas y los placeholders en los campos del formulario:

Opciones de los botones de billetera

Personaliza los botones de billetera exprés mediante las opciones de mount() o externalButtons en la configuración:

Estilos de Secure Fields

Para Secure Fields, pasa styles y externalFonts en las options de cada campo cuando lo creas:
Cada campo es su propio iframe, así que pasa externalFonts a cada campo que use la fuente. Las entradas tienen la misma forma que card.fonts, pero la clave de la familia es family_name (snake case), no familyName. Se aplica el mismo requisito de origen cruzado.