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.
*.y.uno y llama directamente a los servicios de Yuno. El white label te permite servir ese mismo checkout alojado bajo tu propio dominio (por ejemplo, pay.yourbrand.com) sin la marca de Yuno. Cada solicitud posterior (paquete del SDK, recursos, API, WebSocket, 3DS) se enruta a través de tu infraestructura.
Cómo funciona
Dos elementos hacen que el checkout alojado se muestre bajo tu dominio:- Un proxy bajo tu dominio que reenvía el tráfico de checkout, recursos, API y WebSocket a los upstreams correspondientes de Yuno, de modo que el navegador solo se comunique con tu origen. Consulta White Label Proxy Server para ver una implementación de referencia y un entorno de pruebas local.
- Una URL de redirección reescrita. La API de Yuno devuelve la URL predeterminada
checkout.<env>.y.uno, por lo que tu backend la intercepta y la reescribe antes de entregarla al cliente: cambia el dominio por el tuyo y agrega los parámetros de consultaapiUrl/assetUrlque indican al SDK adónde enrutar las solicitudes y desde dónde cargar los recursos.
Pasos para reescribir la URL
Realiza estos pasos en tu backend, sobre la URL de redirección devuelta por la API de Yuno:- Intercepta la respuesta de la API. Captura el payload que contiene la URL de redirección predeterminada
checkout.<env>.y.unogenerada por Yuno. - Reemplaza el dominio base. Cambia
checkout.<env>.y.unopor tu dominio con white label (por ejemplo,pay.yourbrand.com). - Agrega los parámetros de consulta requeridos. Añade
apiUrlyassetUrl. El SDK depende de estos overrides para enrutar todas las solicitudes de pago posteriores y cargar los recursos visuales a través de tu infraestructura en lugar de la de Yuno. - Registra tus dominios en Yuno. Envía tu dominio de checkout,
apiUrlyassetUrla tu representante de cuenta de Yuno para que los agreguen a la lista de permitidos de seguridad del enlace de pago antes de salir a producción (consulta Seguridad).
Referencia de parámetros
Tanto
apiUrl como assetUrl admiten una subruta (el SDK conserva el prefijo en cada solicitud posterior), por lo que pueden apuntar a un proxy montado bajo una ruta, por ejemplo https://pay.yourbrand.com/checkout.
Normalmente
apiUrl y assetUrl tienen el mismo origen: el proxy bajo tu dominio. El SDK usa el valor tal cual y solo agrega su propio segmento de versión (por ejemplo, …/v1.9/main.js) cuando assetUrl aún no termina en uno.Seguridad
Los parámetrosapiUrl / assetUrl forman parte de un enlace que llega al navegador del cliente, por lo que pueden ser manipulados por un atacante, y assetUrl determina el origen desde el que se carga el script del SDK. Un valor sin validar equivaldría a una ejecución remota de scripts en el checkout. Yuno los protege en consecuencia:
- Lista de hosts permitidos. Un override solo se acepta cuando su host coincide exactamente con un dominio que Yuno aprobó para tus enlaces de pago. La función está desactivada de forma predeterminada: los hosts desconocidos se ignoran y el checkout vuelve al origen de Yuno.
- Solo
https:, coincidencia exacta del host (sin comodines de subdominio), con análisis de URL según WHATWG (de modo que trucos comohttps://approved@evil.comse resuelven aevil.comy se rechazan).
Qué elementos se desmarcan
Cuando un override de white label válido está activo, la estructura del checkout alojado se muestra sin marca:- El
<title>de la pestaña del navegador y los metadatos son neutros (sin “Yuno”). - El elemento de carga y su evento DOM usan la superficie neutra
sdk-payments-*(acorde con el cambio de nombre del White Label del SDK). - La etiqueta “Secure by Yuno” se oculta.
- Ninguna solicitud
*.y.unose origina desde la página: el paquete del SDK, los recursos, el BFF de checkout, REST/WebSocket y 3DS se resuelven a través del origen de tusapiUrl/assetUrl.
Requisitos
- Una compilación del checkout alojado con soporte de white label (checkout shell en
@yuno-payments/sdk-web^1.9.1o posterior, la misma versión que incluyó el cambio de nombre del White Label del SDK). - Tu dominio de checkout,
apiUrlyassetUrlincluidos en la lista de permitidos por Yuno. - Un proxy bajo tu dominio que reenvíe a los upstreams de Yuno. Consulta White Label Proxy Server.
Verificación de la configuración
Carga un enlace de pago con white label y confirma en las DevTools del navegador:- Pestaña Network: no hay solicitudes a ningún host
*.y.uno(paquete del SDK, BFF de checkout, REST, WebSocket, 3DS). Todo el tráfico va a tu dominio. - El título de la pestaña del navegador y el elemento de carga no tienen marca, y la etiqueta “Secure by Yuno” no aparece.
- Un pago (incluido un desafío 3DS, si aplica) se completa de extremo a extremo y regresa al checkout bajo tu dominio.
Véase también
- White Label (Web SDK): los overrides
apiUrl/assetUrly la superficie del SDK sin marca en los que se basa esta página. - White Label Proxy Server: proxy de referencia y entorno de pruebas local para ambas superficies de white label.
- Payment Links: cómo crear los enlaces a los que aplica esto.