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.
Modos de visualización
El parámetrorenderMode determina cómo se presentan los formularios de pago a tus clientes. Puedes elegir entre un modal emergente o incrustar el SDK directamente en un elemento HTML de tu página.
Ejemplo: incrustar como un elemento
Si eligeselement, debes proporcionar un selector para el contenedor. Allí se montarán el formulario del APM y el formulario de acción (por ejemplo, el código QR de PIX).
Personalización del formulario de tarjeta
El objeto de configuracióncard te permite modificar la apariencia de los campos de datos sensibles de la tarjeta (número de tarjeta, vencimiento, CVV). Estos campos se renderizan dentro de un iframe seguro para cumplir con PCI.
Inyección de CSS
Usa la propiedadstyles para inyectar CSS personalizado directamente en el iframe del formulario de tarjeta. Esto te permite adaptar el SDK a la estética de tu sitio.
Fuentes personalizadas
Las fuentes de tu página no están disponibles dentro del iframe de la tarjeta. Usa la propiedadfonts para cargar archivos de fuentes dentro de él y luego haz referencia a la familia por nombre desde styles. fonts solo carga los archivos; styles los aplica.
El iframe carga 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 formulario recurre a la siguiente fuente de tu lista font-family. Para Secure Fields, pasa options.externalFonts a cada campo.Etiquetas y textos personalizados
Puedes sobrescribir los placeholders y las etiquetas de los botones predeterminados para que se ajusten mejor al tono de tu app o a tus requisitos de idioma.Controles generales de la UI
Modifica comportamientos generales del SDK, como los loaders, los formularios de emisor y la visibilidad de los botones.Control del loader del SDK
De forma predeterminada, Yuno muestra un spinner de carga durante las transiciones. Puedes ocultarlo si prefieres usar el estado de carga de tu propia app.Visibilidad del botón de pago
En los casos en que quieras activar el pago exactamente desde la lógica de tu propia UI, puedes ocultar el botón “Pay” integrado del SDK.Gestión avanzada del flujo
Rendimiento y reintentos
Si una transacción falla, puedes actualizar la sesión sin desmontar el formulario, lo que asegura una experiencia más fluida para los reintentos.Consideraciones sobre WebView (Mercado Pago)
Si estás integrando en un entorno WebView y usando Mercado Pago Checkout Pro, debes manejar los resultados de redirección que devuelvecontinuePayment().