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.
El soporte white-label permite que un partner sirva el Yuno Web SDK desde su propio origen sin que la cadena Yuno se filtre a la página del comercio: ni en el DOM, ni en los globales, ni en los eventos despachados, ni en el tráfico de red saliente.
Disponible desde el Web SDK 1.9.1. El global heredado window.Yuno y el evento yuno-sdk-ready se mantienen como alias de compatibilidad con versiones anteriores, por lo que las integraciones existentes siguen funcionando sin cambios.

Qué expone el SDK

Tanto el global nuevo como el heredado hacen referencia al mismo objeto, y ambos eventos se despachan al cargar el bundle, por lo que puedes combinarlos durante una migración sin romper ninguna de las dos formas.

Sobrescrituras de URL en tiempo de ejecución

Los partners que alojan el SDK en su propio origen apuntan el SDK a endpoints personalizados al momento de initialize(), en lugar de depender de los valores predeterminados de tiempo de compilación.
Qué afecta cada sobrescritura de punta a punta:
Para un despliegue white-label típico, pasa el mismo valor a ambas opciones. El SDK usa el valor tal cual: ya no agrega un segmento /v<x.y> cuando assetUrl ya termina en uno, y no antepone un prefijo regional a las sobrescrituras.El reemplazo de host de la CDN estática (íconos, logos de marca, banderas) se enruta a assetUrl cuando está definido y, en caso contrario, recurre a apiUrl, por lo que pasar el mismo valor a ambos envía todas las solicitudes a través de un único origen. Solo se reescriben las URL de recursos *.y.uno; los íconos proporcionados por el comercio en CDN externas no se modifican.

Callbacks neutrales del comercio

Los nombres de los callbacks incorporaron alias neutrales para white-label. Los nombres heredados yuno* todavía se aceptan y se reenvían internamente, pero están obsoletos y se eliminarán en una versión mayor futura.

Ejemplo de integración

Verificar una configuración white-label

Después de cargar el SDK desde un origen que no es de Yuno, nada de lo siguiente debería aparecer en la página del comercio:
  • Elementos con class="yuno-*" o id="yuno-*".
  • Una familia de fuente resuelta Yuno-Inter.
  • Solicitudes de red a hosts *.y.uno, incluidas las CDN estáticas icons.prod.y.uno y sdk.prod.y.uno para íconos, logos de marca y banderas. Estas se reemplazan por tu origen solo en compilaciones recientes del SDK; las compilaciones anteriores todavía las obtienen directamente de la CDN.
  • Desde el SDK 1.10.9, un 404 para /sdk-static-bundles-ms/… en tu origen (la hoja de estilos de la fuente). Tu proxy debe reenviar /sdk-static-bundles-ms/* a prod.y.uno. Consulta Rutas que un proxy de partner debe reenviar.
Y esto debería estar presente:
  • window.SdkPayments se resuelve a la fábrica de instancias del SDK.
  • 'sdk-payments-ready' se dispara una sola vez al cargar el bundle.
  • Los nodos del DOM usan class="sdk-payments-*" / id="sdk-payments-*".

Arnés de prueba local

Un servidor proxy desechable se encuentra en el repositorio yuno-payments/yuno-sdk-web, dentro de white-label-proxy-server/. Escucha en http://localhost:9090, sirve una página de inicio desde un origen que no es de Yuno y hace proxy de forma transparente del tráfico de recursos / API / WebSocket del SDK hacia el upstream. Apunta el <script src> de una página de prueba del partner a http://localhost:9090/v1.7/main.js para ejercitar de punta a punta las rutas de código white-label.
La versión v1.7 de arriba y la versión v1.9 del Ejemplo de integración son intencionales, no un error tipográfico: v1.9 muestra una versión real del SDK en producción, mientras que v1.7 es solo la versión de respaldo codificada en el propio arnés de prueba local (consulta Normalización de versión).
El mismo arnés también funciona como frontal del checkout alojado de Payment Link (normalmente checkout.<env>.y.uno), de modo que esa superficie también puede ser white-label sobre un origen o subruta del comercio. Para el flujo orientado al comercio (reescribir la URL de redirección y agregar apiUrl / assetUrl), consulta White Label de Payment Link. Consulta White Label Proxy Server para ver la arquitectura completa, el flujo de white-label del checkout alojado, el comportamiento de fijación de versión de SDK_MAIN_JS, la matriz de variables de entorno (upstreams de prod / staging / dev) y la tabla de enrutamiento.