> ## Documentation Index
> Fetch the complete documentation index at: https://docs.y.uno/llms.txt
> Use this file to discover all available pages before exploring further.

> ## Agent Instructions
> Test in the sandbox first: base URL https://api-sandbox.y.uno (Test Mode in the Dashboard). Production is https://api.y.uno (Live Mode).
> Every API request needs the public-api-key and private-secret-key headers. Get them in the Dashboard at https://dashboard.y.uno/developers (Developers > Credentials); sandbox and production keys are different.
> Send an X-Idempotency-Key (a UUID) when creating payments, refunds and cancels, so retries do not create duplicates.
> Start with the Quickstart (https://docs.y.uno/docs/quickstart.md) and the agent guide (https://docs.y.uno/agents.md). To search these docs from a coding agent, connect the docs MCP server at https://docs.y.uno/mcp.

# Changelog del Web SDK (Legacy)

> Últimas actualizaciones e historial de versiones del Web SDK (Legacy) de Yuno (v1.x)

## v1.11.58

*16 de noviembre de 2026*

**Core SDK**

* FIXED **Sin error del formulario de tarjeta cuando la página elimina el elemento del SDK**\
  Cuando la página del comercio eliminaba el elemento que le había dado al SDK sin llamar a `unmountSdk()` (por ejemplo, cuando el comprador presionaba atrás mientras cargaba el checkout), el SDK informaba `Element card-form-<uuid> doesn't exist in the DOM` a través del callback `error`. Ahora ya no informa ese error en este caso. El checkout que se estaba renderizando en el elemento eliminado se cierra, igual que antes; solo se deja de informar el error.

**Card**

* FIXED **Los tipos de documento ahora cargan en la inscripción de tarjeta paso a paso**\
  En la inscripción de tarjeta paso a paso (`mountEnrollmentLite` con `card.type` "step"), el paso Documento podía mostrar una lista vacía de tipos de documento, por lo que el comprador no podía guardar la tarjeta. Ahora el paso también lee los datos del país almacenados para la sesión del cliente. Los flujos de pago no cambian, porque una sesión de checkout sigue teniendo prioridad.

## v1.11.57

*12 de noviembre de 2026*

**Core SDK**

* CHANGED **Registro de la presencia del contenedor al montar**\
  Cuando el elemento que se pasa al SDK no está en la página al momento de montar, o salió de la página y se volvió a dibujar, el SDK ahora registra si el elemento estaba presente cuando inició y cuántos milisegundos después salió. Sin cambios para el comprador.

## v1.11.56

*10 de noviembre de 2026*

**Core SDK**

* ADDED **Callback onBillingAddressChanged para checkouts con impuestos**\
  Cuando la sesión de checkout tiene `tax_collection`, pasa `onBillingAddressChanged` a `startCheckout`. El SDK lo llama cada vez que cambia el país o el código postal de facturación del método de pago seleccionado, espera el precio con impuestos y mantiene el botón de pago deshabilitado hasta que responda: mientras tanto el botón dice "Adding tax…", y "Try again to continue" con un aviso y un botón de reintento encima cuando falla la cotización. Un host que dibuja su propio botón de pago lee `form.taxQuoteStatus` (`pending`, `ready` o `error`) desde `onChange`. Sin el callback, el SDK no se monta e informa `TAX_COLLECTION_CALLBACK_REQUIRED`. Con `tax_collection`, Apple Pay es el único botón exprés: Google Pay, PayPal, Revolut Pay y Samsung Pay pasan a la lista como filas con su propio bloque de facturación, y su botón permanece deshabilitado hasta que la facturación sea válida y se haya respondido el precio; un nuevo precio vuelve a montar solo ese botón.

* FIXED **El CVV de la tarjeta guardada muestra su propia etiqueta y la fuente del comercio**\
  En el formulario de tarjeta guardada, el campo del código de seguridad mostraba el título de la sección de la tarjeta (por ejemplo "Información de la tarjeta") en lugar de "CVV" cuando el formulario no estaba en la variante compacta. Ahora usa el mismo texto que el formulario de tarjeta nueva. Los campos de código de seguridad y PIN de la tarjeta del formulario de tarjeta guardada también cargan las fuentes pasadas en `card.fonts`, por lo que ya no vuelven a la fuente predeterminada del navegador.

## v1.11.54

*10 de noviembre de 2026*

**Checkout**

* FIXED **La inscripción en Click to Pay vuelve a funcionar cuando el comprador marca la casilla de consentimiento**\
  En el formulario de tarjeta del Golden Flow, al marcar "Save my information with Mastercard Click to Pay" se veía la marca, pero el SDK la recibía como desmarcada, por lo que la tarjeta se pagaba como una tarjeta normal y nunca se inscribía en Click to Pay. "Remember me in this browser" y la casilla de consentimiento del mandato tenían el mismo problema. Ahora las tres informan lo que ve el comprador.

* FIXED **Bundle de sandbox de Mercado Pago**\
  Las claves de API públicas de sandbox ahora cargan el bundle beta de Mercado Pago en todas las compilaciones del SDK. Las claves de producción mantienen el bundle de producción.

* CHANGED **Sesión de comerciante de Apple Pay e inscripción de PayPal bajo demanda**\
  Cuando la configuración marca la sesión de comerciante de Apple Pay o la inscripción de PayPal como bajo demanda, el SDK la solicita al endpoint sdk-provider cuando el comprador toca el botón, en lugar de leerla de la configuración, por lo que no se crea un token de configuración de PayPal para los compradores que nunca hacen clic en PayPal. El botón de PayPal sigue visible sin un token de configuración en la configuración. Si la solicitud falla, la hoja de Apple Pay o la ventana de PayPal se cierra y el comprador puede volver a tocar mientras el resto del checkout sigue funcionando.

**Lite Web SDK**

* ADDED **Uplift Flex Pay confirma o libera el préstamo después del pago**\
  Después de que el token de un solo uso de Flex Pay se entrega al comercio, el SDK consulta el resultado del pago durante unos 3 minutos. Con SUCCEEDED confirma el préstamo de Uplift con el id elegido por `CONFIRMATION_ID_SOURCE` y emite el resultado de pago Lite normal. Con DECLINED, REJECTED, ERROR o EXPIRED llama a `error()` de Uplift y emite `FLEXPAY_FAILED` con el motivo `PAYMENT_DECLINED`. Si falta el id de confirmación, emite `FLEXPAY_FAILED` con el motivo `CONFIRM_ID_MISSING`, y un tiempo de espera agotado emite `FLEXPAY_FAILED` con el motivo `OBSERVER_TIMEOUT`. Por cada orden de Uplift en una pestaña, la confirmación se envía como máximo una vez y el error como máximo una vez; no se envía nada después de una confirmación, y un cargo exitoso posterior de la misma orden aún puede confirmar después de un error. Si `confirm()` o `error()` de Uplift lanza una excepción, el SDK consulta una vez más y lo reintenta una vez, y cada acción tiene su propio reintento. El comercio recibe un resultado por pago.

* CHANGED **Las opciones de Uplift Flex Pay pasan a startCheckout y Flex Pay es solo Lite**\
  Pasa las opciones de Flex Pay a `startCheckout({..., flexpay: { orderInfo, onAvailabilityChange } })` y móntalo con `mountCheckoutLite({ paymentMethodType: 'FLEXPAY' })`; `mountCheckoutLite` no acepta `flexpay`. Flex Pay se oculta de la lista de pago Full y Seamless Full, y `mountSeamlessCheckoutLite({ paymentMethodType: 'FLEXPAY' })` lanza un error "not compatible". Las opciones de Flex Pay nunca se envían a Monitoring. Un `orderInfo` ausente o inválido y una moneda no compatible se registran como errores. Cuando `confirm()` o `error()` de Uplift lanza una excepción, el resultado del comercio se retiene hasta que termina el único reintento, por lo que el reintento también se ejecuta en un montaje Lite real, y se envía el resultado conocido si el observador agota el tiempo antes.

* ADDED **Billetera de Mercado Pago sin botones propios**\
  `submitOneTimeTokenForm()` ahora controla el formulario de la billetera de Mercado Pago desde el botón del comercio: confirma el correo electrónico, le pide al comprador que elija un método de pago cuando no hay ninguno seleccionado e inicia el pago. Con `showPayButton: false`, en un modal o en un elemento del comercio, los botones Pagar y Volver ya no se muestran una vez seleccionado un método; el botón Continuar del paso del correo electrónico permanece, y los compradores aún pueden cambiar el método en la lista. Un método abierto desde la lista de pago conserva sus botones.

* ADDED **Uplift Flex Pay en Checkout Lite**\
  Pasa las opciones de Flex Pay a `startCheckout({..., flexpay: { orderInfo, onAvailabilityChange } })` y monta Uplift Flex Pay con `mountCheckoutLite({ paymentMethodType: 'FLEXPAY' })`. El SDK reutiliza el runtime de Uplift que ya está en la página, tokeniza la tarjeta virtual de Uplift como un token de un solo uso y se lo entrega a `yunoCreatePayment`.

## v1.11.53

*6 de noviembre de 2026*

**Checkout**

* CHANGED **Mostrar solo el botón de Venmo**\
  Cuando una conexión de PayPal lista paypal en Disable Funding Sources y venmo en Enable Funding Sources, el checkout muestra el botón de Venmo y oculta el botón de PayPal. Los comercios que no configuran esa combinación mantienen los botones que tienen hoy.

**Core SDK**

* CHANGED **Los logs de rendimiento incluyen el tiempo desde la llamada al SDK**\
  Los logs de rendimiento ahora incluyen el tiempo transcurrido desde la llamada del comercio al SDK que inició el flujo, de modo que los inicios lentos se pueden rastrear desde la primera llamada del comercio.

* CHANGED **Los tiempos de descarga de los chunks del SDK se informan como métricas de red**\
  Los chunks JS y CSS de carga diferida del propio SDK ahora informan su tiempo de descarga como métricas de red, con los aciertos de caché marcados, de modo que las cargas lentas de chunks aparecen en el monitoreo. El comportamiento y el tiempo de carga no cambian.

* CHANGED **Las cargas de chunks y billeteras sin terminar se registran cuando la página se oculta**\
  Cuando la página se oculta mientras la descarga de un chunk o el botón de una billetera aún se está cargando, el SDK registra qué cargas seguían abiertas y por cuánto tiempo.

## v1.11.52

*6 de noviembre de 2026*

**Checkout**

* CHANGED **Cada billetera exprés que activas ahora se muestra como botón**\
  Con el apilado horizontal de botones exprés, cada billetera cuyo interruptor Render as express button esté activado ahora se muestra como botón exprés, en el orden de tu lista. Dos reglas sacaban billeteras de la fila: Google Pay pasaba a la lista de métodos de pago en cuanto había una segunda billetera exprés activada (una regla heredada de una solución específica de un comercio), y la fila se detenía en tres botones. Ambas desaparecieron, tal como el Express Checkout de Stripe muestra todas las billeteras disponibles. En lugar de quitar una billetera para que el resto quepa, la fila se ajusta en varias líneas: los botones mantienen un ancho igual, una fila contiene dos en un teléfono y tres cuando hay espacio, y una última línea corta se centra. El orden de la lista, el respaldo a la lista cuando un botón no carga y el apilado vertical se comportan como antes. Los comercios con dos o más billeteras exprés activadas verán a Google Pay pasar de la lista a la fila, y los comercios con más de tres verán cada billetera como botón en dos o más líneas.

## v1.11.50

*3 de noviembre de 2026*

**Apple Pay**

* FIXED **Botón de Apple Pay fuera de Safari**\
  Cuando Apple responde applePayUnsupported para el identificador de comercio en un navegador distinto de Safari, el SDK ya no oculta el botón de Apple Pay solo con esa respuesta: ahora muestra el botón cuando canMakePayments() es true. Los compradores sin tarjeta en Wallet (paymentCredentialsUnavailable) siguen sin verlo.

## v1.11.49

*30 de octubre de 2026*

**Payment Actions**

* FIXED **Ventana de tarjeta de KCP en popup**\
  Cuando un pago o una inscripción con tarjeta de KCP se abre en un popup, la ventana de KCP ya no falla con un error de integración de tarjeta (신용카드 연동 오류) y ahora se completa en el popup.

## v1.11.48

*29 de octubre de 2026*

**Core SDK**

* FIXED **El montaje espera a un contenedor tardío**\
  Cuando el elemento indicado en elementSelector aún no está en la página, el SDK ahora espera hasta 3 segundos a que aparezca antes de informar ELEMENT\_NOT\_FOUND. No cambia nada cuando el elemento ya está presente.

## v1.11.47

*28 de octubre de 2026*

**Checkout**

* FIXED **PayPal enrutado a Braintree muestra el botón de Braintree bajo el método unificado PAYPAL**\
  Una entrada de checkout `PAYPAL` cuya conexión es Braintree ahora muestra el botón de PayPal Braintree (mismo flujo que `PAYPAL_BRAINTREE`, incluida el vault de la sesión del cliente) en lugar de no mostrar nada. El token de cliente de Braintree se lee de la entrada `PAYPAL`, el estilo del botón proviene de `externalButtons.paypal` cuando `externalButtons.paypalBraintree` no está definido, y `isPaymentMethodAvailable` ya no informa `PAYPAL` como no disponible para esa conexión. `PAYPAL_BRAINTREE` mantiene su propio flujo sin cambios.

## v1.11.45

*26 de octubre de 2026*

**Payments**

* FIXED **Corrige los pagos con el país Kosovo (XK)**\
  startCheckout rechazaba countryCode XK por no ser válido, por lo que los pagos creados para Kosovo nunca iniciaban 3DS en la página de redirección y quedaban pendientes. Ahora el SDK acepta XK.

## v1.11.43

*22 de octubre de 2026*

**Fraud & Risk**

* ADDED **Sesión de dispositivo de Risk.js de Checkout.com**\
  Cuando una conexión enrutada a Checkout.com tiene `RISK_JS_ENABLED` activado, una `PUBLIC_KEY` y el subdominio específico del comercio (`MSSD`), el SDK carga Risk.js de Checkout.com en segundo plano cuando se monta el método de pago, publica los datos del dispositivo y envía el `deviceSessionId` devuelto junto con el token y el pago como el id de sesión de terceros `CHECKOUT`, para que Checkout.com pueda reenviarlo como `risk.device_session_id`. Se aplica a todos los métodos de pago enrutados a Checkout.com (tarjetas, billeteras y métodos de pago alternativos). Una falla al cargar el script, al inicializar o al publicar nunca bloquea el checkout: la entrada se deja vacía, la falla se registra y la siguiente solicitud vuelve a publicar. Checkout.com conserva la sesión de dispositivo durante 20 minutos después de emitirla, por lo que un checkout que permanece abierto más tiempo paga sin ella.

**Headless**

* ADDED **apiClientPayment.generateToken acepta varios métodos de pago para un mismo pago**\
  Yuno.apiClientPayment().generateToken({ payment_method }) ahora también acepta un arreglo de exactamente dos elementos, uno por cada tarjeta que financia el mismo pago. Cada elemento acepta los campos que ya acepta un único método de pago (type, card, vaulted\_token, customer, device\_fingerprints, third\_party\_data) más amount: { currency, value }. Junto a payment\_method se requiere un total: { currency, value } para crear el pago: se envía al servicio, que además lo verifica contra el monto de la sesión de checkout. Un arreglo crea un token de un solo uso compuesto y se resuelve con { token, checkout_session, expires_at }. Un objeto mantiene el comportamiento y la respuesta actuales, por lo que las integraciones existentes no se ven afectadas. Un arreglo con menos de dos elementos, un amount.value ausente o no positivo, o un amount.currency vacío se rechaza antes de enviar cualquier solicitud, y el mensaje de error indica el índice del elemento. Los montos de los elementos deben sumar total.value y usar total.currency, como exige el servicio. apiClientPayment().getThreeDSecureChallenge() ahora ejecuta el 3DS de cada tarjeta de un pago así, una tras otra: llámalo una vez por tarjeta, en orden de secuencia, y renderiza cada URL que devuelva. Los pagos con una sola tarjeta se comportan como antes. Requiere @yuno/sdk-web-core 8.29.0.

**Checkout**

* CHANGED **Los campos del formulario siguen el color de campo del Checkout Builder**\
  Cuando el color de campo del Checkout Builder es un color distinto de blanco, los campos del formulario lo adoptan: número de tarjeta, fecha de vencimiento, CVV y PIN de la tarjeta, los campos del cliente, las listas desplegables, las sugerencias de dirección y la ayuda del CVV. Su texto usa los colores de texto del Checkout Builder, los bordes y las opciones resaltadas se mezclan a partir de los colores de texto y de campo, y el campo enfocado se resalta con el color de acento, de modo que el texto claro sobre un campo oscuro sigue siendo legible. El formulario de tarjeta mínimo sigue los mismos colores. No cambia nada cuando el color de campo es blanco o no está definido, sin importar el color de fondo, y los estilos pasados en `card.styles` se siguen aplicando encima.

**Core SDK**

* ADDED **Verifica si un método de pago se mostrará antes de listarlo**\
  El nuevo `yuno.isPaymentMethodAvailable({ paymentMethodType, checkoutSession? })` se resuelve en `true` o `false` para cualquier tipo de método de pago, con la misma decisión que toma el SDK antes de mostrar ese método para la sesión de checkout: el método debe estar habilitado para la sesión y, en los métodos que el SDK verifica primero contra el dispositivo o el navegador, ejecuta esa misma verificación (por ejemplo, Apple Pay en el navegador y en el dispositivo, `isReadyToPay` de Google Pay o un proveedor de PayPal compatible). Los comercios que dibujan su propia lista de métodos de pago (Lite, Seamless Lite, botones exprés dentro de su propia lista) pueden llamarlo después de `startCheckout`, o pasar `checkoutSession`, y ocultar los métodos que no se mostrarían. Nunca se rechaza: cuando la sesión no tiene métodos de pago, la solicitud falla o falla una verificación del dispositivo, se resuelve en `false`.

**PayPal**

* FIXED **La ventana de PayPal se cierra cuando el comercio informa un error de creación de pago**\
  En el flujo de trabajo Full, cuando la creación del pago falló y el comercio llamó a `yuno.notifyError()`, la ventana de PayPal se quedaba en su pantalla de carga y nunca se cerraba, tanto al pagar con PayPal como al guardar una cuenta de PayPal (inscripción de PayPal). Ahora se cierra y el checkout permanece montado para que el comercio pueda reintentar; no se muestra ningún estado de error.

**Lite Web SDK**

* ADDED **Compatibilidad con la inscripción de KCP PAYCO**\
  La inscripción de PAYCO a través de KCP (`KCP_PAYCO`) en navegadores de escritorio ahora muestra el mismo botón de KCP que KakaoPay: abre la ventana de PAYCO de KCP al hacer clic y reenvía el resultado de KCP a la URL de resultado de la inscripción, de modo que el comprador llega a la página de éxito o de error del comercio.

## v1.11.42

*20 de octubre de 2026*

* FIXED **Espaciado y divisor de Más opciones**\
  En el diseño de Moon Active, la sección "More options" ya no cubre el borde del método de pago guardado, y muestra el divisor "Or pay with" entre los botones exprés y los demás métodos de pago. El diseño plegado también recibe el espaciado sobre "More options".

## v1.11.41

*20 de octubre de 2026*

**Checkout**

* FIXED **Los textos de las casillas conservan la fuente del checkout**\
  En las páginas host que definen fuentes en todos los elementos con una regla `*`, el texto de cada casilla (guardar tarjeta, guardar tras el éxito, facturación igual al envío, consentimiento del mandato, registro en Click to Pay y recordarme) y de las opciones de radio de Click to Pay usa la fuente, el grosor y el espaciado del checkout, como los nombres de los métodos de pago.

## v1.11.40

*20 de octubre de 2026*

**PayPal**

* FIXED **Corrige la pantalla de carga de PayPal en iPhone y iPad**\
  En iPhone y iPad (Safari y todos los demás navegadores allí), las ventanas de PayPal y Venmo, incluido guardar una cuenta de PayPal desde el checkout, ahora pueden abrirse como una superposición dentro de la página del checkout en lugar de una pestaña nueva, por lo que ya no se quedan en su pantalla de carga. Yuno activa esto por comercio; los demás dispositivos y comercios mantienen el comportamiento actual.

## v1.11.39

*19 de octubre de 2026*

**Card Payments**

* FIXED **La longitud del CVC sigue al servicio de tarjetas**\
  El campo CVC ahora aplica el `security_code_length` que devuelve el servicio de tarjetas para la marca de la tarjeta, tanto para una tarjeta nueva como para una guardada. Un CVC de 4 dígitos escrito en una marca de 3 dígitos (Elo, Alelo, Edenred, Sodexo, VR) muestra "Invalid security code" en lugar de enviarse, algo que Adyen rechazaba con el código 103 "CVC is not the right length". Amex mantiene 4 dígitos, y las marcas sin longitud del servicio de tarjetas mantienen la regla anterior de 3 o 4 (sdk-web-card 1.92.0).

## v1.11.38

*19 de octubre de 2026*

**Card Payments**

* FIXED **Los frames de tarjeta servidos por Yuno solo llaman a hosts de Yuno**\
  Un frame de tarjeta servido desde y.uno ignora un `apiUrl` o `assetUrl` fuera del dominio de Yuno, para que una página hostil no pueda redirigir los datos de tarjeta que tokeniza. Los frames de marca blanca servidos desde el proxy del comercio conservan sus hosts (sdk-web-card 1.91.1).

## v1.11.37

*17 de octubre de 2026*

**Checkout**

* FIXED **Reintento de BLIK con showPaymentStatus en false y el intento rechazado en yunoPaymentResult**\
  Con `showPaymentStatus` en `false`, un pago BLIK rechazado por un código inválido o vencido se reintenta de nuevo en línea, como una tarjeta. En un reintento en línea (tarjeta o BLIK), el formulario permanece abierto con el error y no se muestra ninguna pantalla de estado. Una vez configurado el reintento, `onLoading` informa `PAYMENT_RETRY` y luego `yunoPaymentResult` recibe el intento rechazado con un tercer argumento opcional, `{ isRetrying: true, newCheckoutSession }`: el comprador aún puede pagar, así que no muestres una falla por ello. Los callbacks que solo leen los dos primeros argumentos se siguen ejecutando para ese intento. `yunoPaymentResult` sin el tercer argumento es el resultado final del pago. Un comercio que necesite el comportamiento de 1.11.35 desactiva el reintento con la configuración `enable_payment_retry: false`, que también desactiva el reintento de tarjeta.

## v1.11.35

*15 de octubre de 2026*

**Checkout**

* FIXED **La falla de BLIK llega a yunoPaymentResult**\
  Con `showPaymentStatus` en `false`, un pago BLIK rechazado por un código inválido o vencido ya no se reintenta en línea: el formulario se desmonta y el comercio recibe la falla en `yunoPaymentResult`.

## v1.11.34

*15 de octubre de 2026*

**Checkout**

* FIXED **Las listas desplegables se mantienen lejos del botón de pago fijo**\
  Con el botón de pago de Yuno en posición STICKY en móvil, las listas de selección (cuotas, tipo de documento y los demás desplegables) ya no se abren detrás del pie fijo. La altura del pie se le pasa al selector, que ajusta el tamaño de la lista al espacio visible y la abre hacia arriba cuando hay más espacio sobre el campo.

## v1.11.32

*15 de octubre de 2026*

**Card Payments**

* FIXED **RTL en hebreo y persa en el formulario de tarjeta**\
  Los campos seguros del formulario de tarjeta ahora se renderizan de derecha a izquierda para hebreo y persa, en línea con la dirección del shell del checkout.

## v1.11.31

*14 de octubre de 2026*

**Core SDK**

* ADDED **Idioma checo en el checkout**\
  Agrega la localización al checo (cs, cs-CZ) al checkout del Web SDK, alineada con el texto revisado del backend: pantallas de estado de pago e inscripción, formulario de tarjeta, campos obligatorios y lista de métodos de pago.

**Apple Pay**

* ADDED **Apple Pay dentro de un iframe de origen cruzado**\
  Cuando el checkout está incrustado en un iframe de un dominio distinto, el SDK ahora solicita la sesión de comerciante de Apple Pay de la página de nivel superior, algo que Safari exige para completar el pago. Se detecta automáticamente; el dominio de nivel superior debe estar registrado en la conexión de Apple Pay, de lo contrario la sesión vuelve al dominio del iframe como antes. Dentro de un iframe, `externalButtons.applePay.topLevelDomain` reemplaza el dominio detectado (por ejemplo `'app.example.com'`) o desactiva la detección con `false`. Fuera de un iframe no tiene efecto.

**Checkout**

* FIXED **Los nombres de los métodos de pago conservan la fuente del checkout**\
  En las páginas host que definen fuentes en todos los elementos con una regla `*`, los nombres de los métodos de pago en la lista de radios vuelven a usar la fuente, el grosor y el espaciado del checkout, como antes de 1.11.22. Los nombres largos se siguen truncando con puntos suspensivos.

## v1.11.30

*12 de octubre de 2026*

**Customer Fields**

* ADDED **Bloque de dirección de facturación controlado por la lista de campos del backend**\
  La dirección de facturación muestra solo los subcampos que el backend lista en `ui.required_fields` para el grupo (por ejemplo, solo el país) y conserva su título, y muestra el código postal solo para los países que nombra su condición `show_when`. Con un grupo reducido y una dirección de envío obligatoria, la casilla "billing same as shipping" no se muestra y ambas direcciones son independientes. El callback `onChange` ahora incluye `form.paymentMethodType`, `form.vaultedToken` y `form.values.billingAddress` con los valores de la dirección mostrada, para que el comercio pueda cotizar impuestos o recalcular el precio a medida que el comprador completa la dirección.

**Checkout**

* FIXED **El callback de resultado de pago se ejecuta una sola vez**\
  El callback yunoPaymentResult ya no se ejecuta por segunda vez cuando el SDK recibe de nuevo el estado final del mismo pago, por ejemplo después de un desafío 3DS o una confirmación por OTP.

## v1.11.29

*12 de octubre de 2026*

**Core SDK**

* FIXED **Los botones exprés ya no inician un segundo pago en la misma sesión de checkout**\
  Mientras un botón exprés (PayPal, Apple Pay, Google Pay, Samsung Pay, Revolut Pay, PayPal vía Braintree) estaba en curso, tocar otro creaba un segundo pago que fallaba con una sesión de checkout ya utilizada. Ahora ese toque se ignora. Una vez que la sesión de checkout tiene un pago, un nuevo toque exprés informa `yunoError` pidiendo una nueva sesión de checkout, y no se desmonta nada en pantalla.

**Checkout**

* FIXED **Se restaura el divisor "Or pay with" sobre los demás métodos de pago**\
  El divisor "Or pay with" debajo de los botones exprés se renderiza de nuevo en los diseños expandido y Moon Active siempre que haya una fila de método de pago listada debajo.

## v1.11.28

*12 de octubre de 2026*

**Core SDK**

* ADDED **Los eventos del SDK informan cuánto debe desplazarse la página para llegar al botón de pago del formulario abierto**\
  `checkout.completed` y `checkout.abandoned` ahora incluyen `scroll_needed_px`, cuánto debe desplazarse la página desde su parte superior para que el botón de pago del formulario del método de pago abierto quede en pantalla, y `viewport_height_px` como contexto. El valor es una medición de diseño: es el mismo dondequiera que el comprador se haya desplazado, y un formulario más corto lo reduce. Se lee cuando se abre un formulario (al seleccionar en la lista desplegada, cuando el formulario se muestra en los modos de renderizado modal y de elemento), de nuevo cada vez que el área del SDK o el modal del SDK cambian de tamaño mientras carga el formulario, cuando el comprador confirma el pago y cuando se envía el evento; una lectura que encuentra el botón de pago siempre prevalece y una que no lo encuentra nunca la reemplaza, por lo que el cargador de pago no la sobrescribe. Apunta al botón de pago visible del SDK: el botón de pago del método seleccionado en el acordeón, el botón de pago único, el botón de pago del pie del modal o el botón de envío del formulario, contando el desplazamiento que queda dentro de un modal con scroll o una superposición modal. Un botón de pago fijo informa 0. Cuando el comercio renderiza su propio botón, se usa como sustituto la parte inferior de lo que dibujó el SDK. No se envía nada cuando no se abrió ningún formulario. El existente `scroll_distance_px` no cambia.

* ADDED **Enrollment Lite puede abrir la página del proveedor en una ventana emergente**\
  Cuando el proveedor de una inscripción respondía con una acción de popup, Enrollment Lite abría la página del proveedor en una ventana propiedad del SDK en lugar de reemplazar la página, como ya hacen los métodos de pago con redirección. La página del comercio permanecía montada detrás de una superposición de inscripción, y el estado de la inscripción se resolvía como ya lo resuelve cada versión de Enrollment Lite, por lo que no fue necesario ningún cambio de integración. Cuando el navegador bloqueaba la ventana, el comprador veía un botón Continuar. Las inscripciones respondidas con una redirección simple mantuvieron la redirección en la misma pestaña.

**Installments**

* CHANGED **Las opciones de cuotas se identifican por el id del plan**\
  Cuando dos opciones de cuotas tenían el mismo número de cuotas, al elegir la segunda se mostraba la primera. Ahora las opciones se identifican por su id de plan, el id del plan seleccionado viaja con el token de un solo uso, y las opciones con interés muestran una etiqueta de interés. El callback onInstallmentSelected también recibe el id del plan, el tipo de plan y sus costos financieros.

## v1.11.27

*8 de octubre de 2026*

**Lite Web SDK**

* ADDED **Compatibilidad con redirección POST y con la inscripción de KCP KakaoPay**\
  La inscripción Lite ahora sigue una acción REDIRECT\_URL que pide un POST de formulario: cuando require\_action.redirect trae el método POST (en cualquier combinación de mayúsculas) y form\_fields, el SDK envía un formulario oculto a init\_url una vez por inscripción en lugar de navegar con un GET, cuando init\_url está en un host de KCP (https, \*.kcp.co.kr). Toda otra redirección, incluido un POST a cualquier otro host, sigue provider.redirect con un GET, como antes. La inscripción de KakaoPay a través de KCP en navegadores de escritorio muestra un botón que carga KCP (solo desde https *.kcp.co.kr) apenas se renderiza, abre la ventana de KakaoPay de KCP al hacer clic y reenvía el resultado de KCP a la URL de resultado de la inscripción (solo un host de Yuno o el host del apiUrl de marca blanca), de modo que el comprador llega a la página de éxito o de error del comercio. Un resultado que KCP envía después de cerrar su ventana se sigue reenviando. Si KCP no logra cargar, el botón muestra un error en línea y un clic vuelve a cargar KCP; si los datos de la inscripción no son utilizables, el botón se deshabilita y muestra un error en línea; si el comprador cierra KCP sin un resultado, el botón se habilita de nuevo para que el comprador pueda reintentar. Si el envío del resultado no sale de la página (por ejemplo, una Content Security Policy sin form-action para el host de la URL de resultado), el botón se habilita de nuevo con un error en línea. Desmontar el SDK cierra la ventana de KCP y restaura un callback de KCP que la página tenía antes. Los comercios con una Content Security Policy estricta necesitan los hosts de KCP en script-src y frame-src, y form-action para el host de la URL de resultado (*.y.uno, o el host del apiUrl de marca blanca) y \*.kcp.co.kr.

## v1.11.25

*6 de octubre de 2026*

**Core SDK**

* ADDED **Los botones exprés siguen la configuración "Render as express button" del Checkout Builder**\
  Cada billetera con capacidad exprés (Apple Pay, Google Pay, PayPal, PayPal Braintree, Revolut Pay, Samsung Pay) ahora se muestra como un botón exprés sobre la lista o como un elemento normal de la lista según la configuración "Render as express button" de cada método publicada desde el Checkout Builder. Si está desactivada, la billetera toma su posición en la lista y libera su espacio exprés. El máximo de tres botones horizontales, la prioridad por orden de la lista, la regla de botón único de Google Pay y las verificaciones de capacidad del dispositivo siguen funcionando como antes, y los comercios sin la configuración mantienen el renderizado actual. Los métodos de inscripción de PayPal siguen la configuración de PayPal, y `onlyExpressPaymentMethods` informa una billetera desactivada como elemento de la lista.

* ADDED **Analítica del consentimiento de débito directo**\
  El SDK ahora informa el paso de autorización de débito directo: cuando se muestra el texto del mandato, cuando el comprador lo acepta y, donde un esquema o un comercio exige una casilla explícita, cada marca y cada envío bloqueado. Cada evento incluye la versión de la redacción que se mostró, de modo que el abandono en el paso de consentimiento se pueda medir por plantilla. Los eventos en sí no transportan ninguna redacción.

* ADDED **Voucher como tercera opción de tipo de tarjeta para tarjetas multibeneficio de Brasil**\
  Cuando la consulta de tarjeta informa que una tarjeta de crédito o débito brasileña también puede usarse como voucher (tarjetas multibeneficio como Swile, Caju o Pluxee, conforme al decreto 12.712/2025), el selector de crédito/débito del formulario de pago con tarjeta y del formulario de inscripción de tarjeta ofrece una tercera opción, "Voucher". Al elegirla, la tarjeta se envía como voucher y se omite la consulta de cuotas, igual que al elegir débito. Las tarjetas sin esa marca conservan las dos opciones, y las tarjetas ya identificadas como vouchers mantienen el comportamiento actual. Con el procesamiento solo de crédito habilitado, el selector muestra crédito y voucher para esas tarjetas en lugar de permanecer oculto. Los formularios de tarjeta paso a paso y el formulario de tarjeta de Click to Pay conservan el selector actual.

* CHANGED **El botón propio de la billetera ocupa el lugar del botón Yuno Pay cuando se selecciona una billetera de la lista**\
  Con el botón Yuno Pay habilitado (flotante o fijo), al seleccionar una billetera exprés que se muestra como elemento de la lista (Apple Pay, Google Pay, PayPal, PayPal Braintree, Revolut Pay, Samsung Pay) ahora se oculta el botón Yuno Pay y se renderiza en su lugar el botón nativo de la billetera, en la misma posición y variante, para todos los comercios y en todos los diseños de lista. El botón dentro de la fila de la lista no se renderiza mientras el botón de la billetera ocupa el espacio del botón de pago, y al seleccionar otro método vuelve el botón Yuno Pay. Con el botón Yuno Pay deshabilitado, o en modo acordeón, el botón de la billetera sigue renderizándose dentro de su fila como antes. Esto estaba disponible antes solo para la experiencia de Moon Active.

* ADDED **Los métodos de pago con redirección pueden abrirse en una ventana emergente**\
  Cuando una conexión de proveedor está configurada para abrir su redirección en un popup, los métodos de pago basados en redirección abrían al proveedor en una ventana propiedad del SDK en lugar de reemplazar la página. La página del comercio permanecía montada, el SDK esperaba el resultado del pago, cerraba la ventana y disparaba los callbacks de resultado existentes, por lo que no fue necesario ningún cambio de integración. La ventana se abría en el paso en el que antes se redirigía la página; cuando el navegador la bloqueaba, el comprador veía un botón Continuar al pago. Las conexiones sin esa configuración mantuvieron la redirección en la misma pestaña.

* FIXED **Mercado Pago Fast Payments carga su script una sola vez y conserva sus etiquetas en conexiones lentas y navegadores antiguos**\
  El script de Mercado Pago ya no se agrega dos veces cuando la precarga y el cargador de la billetera lo piden mientras aún se descarga, y una descarga fallida se puede reintentar. Cuando Mercado Pago es el único método del comercio y la billetera recurre al respaldo, la fila restante conserva su nombre. El recuadro del método seleccionado conserva el color de acento del comercio y solo se dibuja en navegadores que admiten :has(), por lo que los navegadores antiguos mantienen la fila seleccionada simple. El control de cierre de la hoja Lite tiene un nombre accesible, y la precarga ya no descarga el chunk del componente Lite.

* FIXED **La pantalla de pago pendiente ya no invita a reintentar**\
  En la pantalla de estado pendiente, el botón ahora dice "Close" en lugar de "Try again", y el título y el mensaje ya no advierten sobre cobros duplicados: el título es "Your payment is being confirmed" y el mensaje es "We're confirming your payment. You'll be notified once it's complete." El botón se comporta como antes: informa el estado real del pago a través de yunoPaymentResult y cierra el SDK. Las pantallas de rechazo y de error conservan "Try again", y los callbacks, los estados y las clases CSS no cambian.

**Formulario de tarjeta**

* FIXED **Formularios más compactos: vuelve la línea entre la fecha de vencimiento y el CVV**\
  En el formulario de tarjeta más compacto, el divisor entre la fecha de vencimiento y el CVV quedaba tapado por el recuadro del CVV, por lo que los dos campos se juntaban. Se dibuja de nuevo en el gris del campo, como la línea entre el tipo y el número de documento, también en los idiomas de derecha a izquierda.

**Checkout**

* CHANGED **Lista de métodos de pago sin el contorno en el método seleccionado**\
  La lista de métodos de pago tiene un marco más ligero (un anillo fino del mismo gris que los campos del formulario, con una sombra suave y esquinas de 6px) y el método seleccionado ya no se contornea con el color de acento; el radio marca la selección. Con el botón Yuno Pay dentro de cada método (acordeón), la tarjeta seleccionada recibe un fondo gris claro y un borde gris en lugar del contorno; con un color de fondo personalizado, esos grises se mezclan a partir de los colores de texto y de fondo del propio comercio para que los temas oscuros sigan siendo legibles. La lista de Mercado Pago Fast Payments sigue la misma regla.

## v1.11.24

*2 de octubre de 2026*

**Core SDK**

* ADDED **El token de un solo uso ahora incluye el nombre del banco de ACH**\
  Para una transferencia bancaria ACH, el segundo argumento de los callbacks `createPayment` y `yunoCreatePayment` ahora incluye `bank_transfer.bank_name`, el nombre del banco que Yuno deriva del número de ruta, o el valor enviado en la solicitud del token. Solo se expone el nombre del banco: los números de cuenta y de ruta nunca se devuelven en el token. Los tokens de otros métodos de pago no incluyen la clave. El campo está tipado en `OneTimeToken` (`bank_transfer?: { bank_name?: string }`), por lo que las integraciones con TypeScript lo leen sin un cast.

## v1.11.23

*2 de octubre de 2026*

**Payment Methods**

* FIXED **Pix Parcelado sin los términos de Koin**\
  El formulario de Pix Parcelado ya no muestra la casilla de términos de Koin ni el selector de cuotas de Koin. Aparecían para todos los proveedores de Pix Parcelado siempre que el comercio tuviera habilitados los campos de cliente obligatorios, por lo que un comprador de Pagaleve debía aceptar la política de privacidad de Koin antes de pagar. Ahora el formulario muestra solo los campos genéricos del cliente, y la página del propio proveedor gestiona las cuotas y los términos.

## v1.11.22

*1 de octubre de 2026*

**Card**

* ADDED **Aviso de promoción sobre el formulario de tarjeta y la cotización como evento**\
  Cuando la sesión tiene las promociones habilitadas, el SDK pide una cotización justo después de que card-info responde y muestra, sobre los campos de la tarjeta, que la tarjeta tiene un descuento disponible. El chip y el banner muestran el monto del descuento, desaparecen al cambiar de tarjeta y nunca se muestran ante un error o un tiempo de espera agotado. La cotización también se entrega a la página host a través del nuevo callback `onPromotionQuoteUpdated`, que recibe la oferta cuando la tarjeta califica y null cuando deja de aplicar, de modo que un resumen de orden propiedad de la página pueda mostrar y revertir el total con descuento; la oferta nunca incluye el token de una tarjeta guardada. Un token de tarjeta también lleva la cotización en el segundo argumento de los callbacks `createPayment` y `yunoCreatePayment`, como `quote: { type: 'YUNO_PROMOTION', quote_id }`, que el comercio reenvía en `additional_data.order.discounts` del pago para que se cobre el descuento. Un token de billetera nunca la lleva. Una tarjeta almacenada también se cotiza, mediante su `vaulted_token` en lugar de un BIN que nunca expone, por lo que un comprador que paga con una tarjeta guardada ve el mismo descuento y lleva la misma cotización en el token. Los comercios pueden fijar cómo se presenta la promoción mediante `features.promotions_card_display` y `features.promotions_express_display`; ambos usan por defecto la regla contextual, por lo que un comercio sin configurar no ve ningún cambio. Un checkout que nunca monta un formulario de tarjeta no produce BIN y por lo tanto no se puede cotizar: `features.promotions_batch_enabled`, desactivado por defecto, cambia esas superficies a una cotización que cubre toda la lista de métodos de pago y se ejecuta antes de que se escriba una tarjeta. Cuando un pago se rechaza porque su cotización ya no es válida, la página host puede llamar a `refreshPromotionQuote()` en la instancia de Yuno para pedir una cotización nueva para la tarjeta actual, que llega a la página a través de `onPromotionQuoteUpdated` y no hace nada cuando las promociones están desactivadas.

## v1.11.21

*1 de octubre de 2026*

**Core SDK**

* ADDED **Etiqueta "Saved account" en los métodos de pago guardados que no son tarjetas**\
  La lista de métodos de pago ahora muestra una línea traducida "Saved account" debajo de cada método de pago guardado que no sea una tarjeta, para que se puedan distinguir una entrada guardada y la opción de pagar con una cuenta nueva del mismo método, incluso cuando el nombre no lleva ningún identificador. Las tarjetas inscritas conservan su vista previa y las filas de la billetera de Mercado Pago no cambian. Para el estilo, la etiqueta de la fila lleva el modificador `sdk-payments-payment-list__payment-method--saved` y las dos líneas son `sdk-payments-saved-account-preview__name` y `sdk-payments-saved-account-preview__label`.

* CHANGED **Una sola sección de Mercado Pago en todos los estados**\
  Los métodos guardados de Mercado Pago ahora viven bajo un único encabezado de Mercado Pago pase lo que pase: la sección pide el correo electrónico de la cuenta cuando la sesión de checkout no lo trae, muestra un marcador mientras carga la billetera, lista los métodos guardados una vez que esta responde, y se retira por completo cuando no se puede llegar a Mercado Pago, de modo que el comprador ve la lista normal sin ningún aviso. Su aviso de privacidad siempre enlaza a la página de privacidad de Mercado Pago del país del comprador, el enlace que pidió Mercado Pago. La fila separada de Mercado Pago que antes abría un panel para esos casos ya no se renderiza en el checkout Full. El encabezado de la sección muestra el logo de Mercado Pago en el mismo recuadro cuadrado redondeado que cualquier otro ícono de marca de la lista.

* CHANGED **Recuadro cuadrado de Mercado Pago servido desde los assets del SDK**\
  El encabezado de la sección de Mercado Pago ahora carga su recuadro cuadrado desde el bucket de marcas del SDK, como cualquier otro ícono de marca, en lugar de llevarlo dentro del bundle.

* ADDED **Modo de pantalla de estado informado en el evento de analítica checkout.opened**\
  El evento `checkout.opened` ahora incluye un atributo `status_screen` que registra si el comercio renderiza la pantalla de estado de pago de Yuno (`yuno`) o la suya propia (`merchant`, cuando el SDK se inicializa con `showPaymentStatus: false`). Las integraciones cuyas opciones no incluyen la configuración, como Secure Fields, omiten el atributo en lugar de informar un valor por defecto que nunca eligieron. Solo analítica: no hay cambios en el comportamiento del checkout, la pantalla de estado ni ningún callback del comercio.

* CHANGED **Los métodos guardados de Mercado Pago siguen la preferencia del Checkout Builder**\
  Cuando el Checkout Builder marca a Mercado Pago como el método preferido, el primer método guardado de Mercado Pago del comprador se preselecciona apenas responde la billetera, en lugar de que quede seleccionado el primer método del comercio. Los comercios que prefieren otro método no ven ningún cambio.

* CHANGED **Los métodos guardados de Mercado Pago cargan antes**\
  El checkout Full ahora descarga el script de Mercado Pago y obtiene la configuración de Mercado Pago mientras el SDK aún está arrancando, en lugar de hacerlo después de que se renderiza la lista de pago. Los métodos guardados de Mercado Pago del comprador aparecen antes; las sesiones sin Mercado Pago no se ven afectadas.

* CHANGED **Estado de procesamiento para el botón Yuno Pay**\
  Con el botón Yuno Pay habilitado, al enviar un formulario de tarjeta, tarjeta inscrita, inscripción o método de pago alternativo, se muestra un spinner de Processing dentro del botón, se oculta el cargador de pantalla completa y se bloquean los campos del formulario, el botón de cierre del modal y la lista de métodos de pago. Fuera de seamless, el bloqueo termina cuando se crea el token de un solo uso. En seamless, el SDK ahora crea el pago y ejecuta el siguiente paso del pago justo después del token, sin el evento create-payment, y mantiene el bloqueo hasta que ese paso se muestra. Los métodos sin formulario siguen la misma regla a través del botón Yuno Pay. Con el botón Yuno Pay deshabilitado, los formularios mantienen el comportamiento actual.

**Google Pay**

* FIXED **Google Pay en Chrome para Android ya no falla con CALLBACK\_TIMED\_OUT**\
  En Chrome para Android, la hoja de Google Pay podía detenerse con CALLBACK\_TIMED\_OUT y el comprador no podía pagar. El SDK ya no solicita el callback de autorización de pago de Google, por lo que no queda ningún callback que pueda agotar el tiempo; `onLoading` para el token de un solo uso ahora se dispara cuando la hoja de Google Pay devuelve los datos del pago. `onLoading` también informa `isLoading: false` cuando el token o la solicitud de pago fallan después de que se cierra la hoja, por lo que ya no queda en `true`.

## v1.11.20

*29 de septiembre de 2026*

* FIXED **La lista de sugerencias de direcciones y el campo del código de seguridad de Mercado Pago vuelven a tener ids únicos**\
  Desde la 1.11.0, los ids de la lista de sugerencias de direcciones y del campo del código de seguridad de Mercado Pago podían repetirse cuando el SDK renderizaba más de un componente en la misma página, por lo que el campo del código de seguridad de Mercado Pago podía montarse en el elemento equivocado. Estos dos elementos ahora reciben un id que es único en la página.

**Core SDK**

* ADDED **Inscripción unificada de PayPal en el método de pago PAYPAL**\
  El botón externo de PayPal ahora elige su flujo para el método de pago PAYPAL a partir de la conexión enrutada en la configuración del comercio: la sesión de guardado en la bóveda o la sesión de acuerdo de facturación cuando la entrada PAYPAL incluye datos de inscripción de PayPal, y el botón o la redirección de PayPal existentes en los demás casos. La inscripción en Lite y el traspaso de inscripción del checkout aceptan una inscripción PAYPAL que devuelve una acción de proveedor del SDK de PayPal. PAYPAL\_ENROLLMENT, PAYPAL\_BA\_ENROLLMENT y PAYPAL\_BRAINTREE se comportan como antes.

* FIXED **Acuerdo de facturación unificado de PayPal en Lite, con Braintree fuera del método PAYPAL unificado**\
  La inscripción en Lite del método de pago PAYPAL ahora ejecuta la sesión de acuerdo de facturación cuando el id de inscripción de PayPal es igual al id del token de PayPal, la misma regla que usa el checkout, en lugar de iniciar una sesión de guardado en la bóveda con un token de acuerdo de facturación. El método PAYPAL unificado ya no tiene una ruta de Braintree: Braintree no está activado para PAYPAL, por lo que una configuración o inscripción PAYPAL enrutada a Braintree se registra una sola vez como no compatible: Seamless no renderiza ningún botón de PayPal e informa que el botón falló, y la inscripción se queda en Lite. Checkout y Lite comparten una misma regla de acuerdo de facturación. PAYPAL\_BRAINTREE mantiene su propio flujo sin cambios.

**Formulario de cliente**

* FIXED **Los campos de cliente ya no muestran caracteres que rechazaron**\
  Desde la 1.11.0, los campos de cliente que solo aceptan ciertos caracteres (teléfono y número de documento con validación en tiempo real, y otros campos de cliente con máscara) podían seguir mostrando un carácter que habían rechazado, como una letra en un número de teléfono, aunque el valor enviado con el pago ya estaba limpio. Ahora el campo siempre muestra el valor que se enviará, y el cursor se queda donde el comprador estaba escribiendo.

## v1.11.19

*25 de septiembre de 2026*

**Core SDK**

* FIXED **`three_ds.completed` ahora informa el resultado de 3DS en lugar del resultado del pago**\
  Cuando la autenticación 3DS tiene éxito y luego el adquirente rechaza el pago, `three_ds.completed` informa `result: authenticated` y el rechazo queda en `payment.resolved`. El resultado se lee de la última transacción del pago que el SDK ya recibe (su proveedor y código de respuesta). Cuando esa transacción no está disponible, por ejemplo cuando el estado final llega por el websocket, el resultado sigue el resultado del pago como antes. Límite conocido: los proveedores que autentican y autorizan en una sola transacción y no exponen un código de respuesta de 3DS, hoy Adyen (unas 200 sesiones 3DS de Adyen por semana), informan sus rechazos de 3DS como `authenticated` hasta que.

**Formulario de cliente**

* ADDED **Pix en Brasil: tipo de documento inferido del número y un solo campo Full name en lugar de nombre y apellido**\
  Para Brasil, cuando los documentos disponibles son CPF y CNPJ (una entrada PASSPORT se ignora en Pix), el selector de tipo de documento ya no se renderiza: el campo se etiqueta "CPF / CNPJ" y el tipo se infiere de los dígitos (11 o menos → CPF, más → CNPJ), por lo que la máscara, la validación y el payload enviado no cambian. El formulario de cliente también renderiza un solo campo "Full name" en lugar de nombre y apellido, dividido en el primer bloque de espacios en `first_name` / `last_name`; los idiomas que escriben nombres sin espacios (ja, ko, zh, th) mantienen los dos campos. La detección automática del documento está activada por defecto y se puede desactivar por cuenta mediante la función de sdk-ms `document_type_auto_detect`. El campo Full name está activado para la experiencia Moon Active y, en los demás casos, es opcional por cuenta mediante la función de sdk-ms `unified_full_name`; el despliegue a todos los comercios seguirá con una opción en Checkout Builder ("Full name" frente a "First + last name"). Cada parte del nombre debe tener al menos 2 caracteres (el mismo mínimo que aplicaban los dos campos separados), por lo que "Ana B" se rechaza con el mensaje "Enter your first and last name"; el límite de 100 caracteres no cambia. Textos de los campos de cliente (globales, sin restricción por experiencia): el campo Full name reducido muestra "Enter full name" en lugar de la sugerencia del nombre; el grupo de teléfono reducido lleva una sola etiqueta "Phone" sobre el selector de prefijo y el campo del número conserva solo su placeholder (solo el cuadro del número se pone rojo ante un error); en inglés el campo de correo se etiqueta "Email" (ortografía de Stripe); en el formulario predeterminado con etiqueta flotante, el selector de prefijo muestra su etiqueta "Country" solo mientras no hay un prefijo seleccionado, de modo que la bandera y el prefijo preseleccionados quedan centrados en el cuadro.

**Formulario de tarjeta**

* FIXED **El formulario de tarjeta reducido mantiene las cuotas mientras se escriben el vencimiento y el CVV**\
  El formulario de tarjeta reducido mantiene las opciones de cuotas, y el plan seleccionado por el comprador, mientras se escriben la fecha de vencimiento y el CVV. Solo los eventos del número de tarjeta actualizan la información de la tarjeta y las cuotas, por lo que un nuevo número de tarjeta sigue recargándolas.

* ADDED **Logos rotativos de marcas de tarjeta en el campo de número de tarjeta vacío (experiencia Moon Active)**\
  Cuando la experiencia Moon Active está habilitada para la cuenta, el campo de número de tarjeta vacío ahora muestra Visa, Mastercard y Amex, más un cuarto espacio que rota Discover, Diners Club, Maestro y Elo cada 3 segundos, hasta que el comprador escribe suficientes dígitos para detectar la marca. El SDK reenvía la bandera `moonActiveExperience` al formulario de tarjeta; los logos los renderiza sdk-web-card 1.89.3. Los comercios sin la experiencia Moon Active no se ven afectados.

## v1.11.17

*24 de septiembre de 2026*

**PayPal**

* FIXED **El botón de PayPal Enrollment ya no se oculta ni se queda atascado con sesiones obsoletas**\
  El botón exprés de PayPal Enrollment (PayPal JS SDK v6) ya no requiere `provider_token_id` para renderizarse en la inscripción en la bóveda; solo el flujo de acuerdo de facturación lo usa. Cuando el comercio crea el pago, el botón ahora le entrega a PayPal el token de configuración de la inscripción que creó ese pago, con la configuración como alternativa, y solo el último clic espera al pago, por lo que un intento cancelado ya no puede ser resuelto por uno posterior.

* ADDED **Botón de Venmo en el botón exprés de PayPal v6**\
  El botón exprés de PayPal ahora lee el parámetro ENABLE\_FUNDING de la configuración del proveedor del comercio: cuando incluye `venmo`, el SDK crea la instancia del PayPal JS SDK v6 con el componente `venmo-payments` y renderiza un botón de Venmo debajo del botón de PayPal una vez que PayPal confirma que el comprador es elegible (comprador de EE. UU. que paga en USD). Venmo paga la misma orden de PayPal. Con credenciales de sandbox, el SDK también envía `testBuyerCountry=US`, como lo exige la guía de pruebas de Venmo de PayPal, para que QA fuera de EE. UU. vea el botón; producción nunca lo envía.

**Core SDK**

* CHANGED **Botón Yuno Pay en el flujo de inscripción**\
  Con el botón Yuno Pay habilitado, el botón Save de la inscripción se ve deshabilitado hasta que el formulario está completo y sigue siendo clicable para mostrar los errores pendientes. Con el botón Yuno Pay deshabilitado, los formularios de inscripción y de pago mantienen el botón siempre habilitado.

**Apple Pay**

* ADDED **Filtros de aceptación de tarjetas de Apple Pay**\
  La solicitud de Apple Pay ahora toma merchantCapabilities y supportedCountries de wallet\_card\_acceptance de la sesión de checkout (supported\_funding\_types y supported\_countries), por lo que las tarjetas no elegibles aparecen atenuadas en la hoja. Las sesiones que no declaran nada mantienen el comportamiento actual.

**Google Pay**

* FIXED **La hoja de Google Pay muestra un "Total" traducido**\
  La hoja de pago de Google Pay ahora etiqueta el monto con "Total" en el idioma del checkout en lugar de la línea de comercio predeterminada de Google. Cuando el pago incluye un desglose `summary_items` válido, la hoja conserva la etiqueta de total propia del desglose.

**Métodos de pago alternativos**

* ADDED **Campos explícitos de número de institución y número de tránsito para PAD en Canadá**\
  El débito preautorizado (PAD) de Canadá ahora recopila el Institution number (3 dígitos) y el Transit number (5 dígitos) del banco como campos explícitos, en lugar de depender de que el comprador derive un número de ruta combinado. Ambos conservan los ceros iniciales como cadenas de texto y son opcionales en todos los casos, por lo que las integraciones existentes que aún envían `routing_id` no se ven afectadas.

## v1.11.16

*22 de septiembre de 2026*

**Core SDK**

* FIXED **Los scripts antifraude y el botón de Samsung Pay en portugués siguen el host de marca blanca**\
  Con `apiUrl` / `assetUrl` configurados en `Yuno.initialize()`, el script de Forter alojado por Yuno, el beacon SRI de Riskified y la imagen del botón de Samsung Pay en portugués se cargaban directamente desde `*.y.uno` en lugar del proxy del comercio. Ahora se cargan primero desde el host configurado. Si el proxy no puede servirlos (ruta faltante, sin CORS para los scripts SRI, copia obsoleta), se cargan desde Yuno como antes, por lo que no se pierde ninguna huella digital ni ningún botón. Para mantenerlos en el host del comercio, el proxy debe reenviar `/sdk-static-bundles-ms/*` (con su query string y CORS para SRI) a `<env>.y.uno` y `/wallets/*` a `sdk.prod.y.uno`. Los comercios que no usan marca blanca no se ven afectados.

## v1.11.15

*22 de septiembre de 2026*

**Payment Actions**

* FIXED **Corrige un falso error de tiempo de espera del pago**\
  El cargador de procesamiento ya no muestra "Transaction failed" después de haberse cerrado o mientras la página está en segundo plano, y ahora usa el tiempo de espera configurado para el checkout.

## v1.11.14

*22 de septiembre de 2026*

**Card Payments**

* FIXED **Los textos del formulario de tarjeta mínimo están traducidos en todos los idiomas compatibles**\
  Las etiquetas y los placeholders del formulario de tarjeta mínimo (`minimal_card_form_enabled`) solo estaban traducidos en 10 de los 34 idiomas que incluye el SDK, por lo que los comercios en cualquier otro idioma, entre ellos el griego, veían las claves de traducción sin procesar (`minimal_card_number_label`, `minimal_card_number_placeholder`, …) dentro del formulario de tarjeta en lugar de los textos. Los siete textos ahora existen en los 34 idiomas y reutilizan la terminología de tarjeta ya existente en cada idioma. Los comercios sin la bandera no se ven afectados.

## v1.11.13

*22 de septiembre de 2026*

**Card Payments**

* FIXED **Los íconos de marcas de tarjeta siguen el host de marca blanca**\
  Con `apiUrl` / `assetUrl` configurados en `Yuno.initialize()`, el logo de la marca de tarjeta en el campo de número de tarjeta (y los demás íconos dentro de los campos de tarjeta) se cargaba desde `icons.prod.y.uno` en lugar del proxy del comercio. Ahora el SDK pasa ambos hosts a cada iframe de tarjeta que crea (formulario de tarjeta, mediador de campos seguros y cada campo seguro), por lo que esos íconos se cargan desde el host configurado. El logo de la vista previa de la tarjeta guardada también requiere sdk-web-card 1.89.2. Una cadena `apiUrl` / `assetUrl` vacía ahora se trata como no configurada. Los comercios que no usan marca blanca no se ven afectados.

* ADDED **Formulario de tarjeta mínimo para comercios con la tarjeta como único método seleccionable**\
  Detrás de la bandera de función `minimal_card_form_enabled` (desactivada por defecto, habilitada por cuenta por Yuno), el checkout Full renderiza un formulario de tarjeta simple cuando la tarjeta es el único método de pago seleccionable y el formulario de tarjeta desplegado está activado: sin fila de radio ni marco de lista, una etiqueta sobre cada campo, vencimiento y CVV como dos cuadros separados, y la marca de la tarjeta al inicio del campo de número una vez que se resuelve el BIN. Los botones exprés (Google Pay, Apple Pay, PayPal) siguen renderizándose encima. Se usa la lista normal siempre que haya un segundo método seleccionable, una tarjeta guardada, Click to Pay o el formulario más reducido. Requiere sdk-web-card 1.89.2. Los comercios sin la bandera no se ven afectados.

## v1.11.12

*21 de septiembre de 2026*

**Core SDK**

* CHANGED **El checkout Full muestra sus métodos de pago una sola vez, totalmente cargados**\
  Los checkouts Full y Seamless Full muestran un cargador compacto hasta que los botones exprés (Google Pay, Apple Pay, PayPal y los demás) y los campos de tarjeta están listos, y luego crecen hasta mostrar la lista completa de métodos de pago en una sola animación breve, en lugar de mostrar primero la lista y agregar cada botón a medida que carga. Después de 2 segundos, la lista se muestra de todos modos y un botón más lento aparece cuando está listo. Se habilita por comercio con la bandera de función `reveal_methods_together_enabled`; sin ella, el checkout carga como antes.

## v1.11.11

*21 de septiembre de 2026*

**Core SDK**

* FIXED **Enlace de pago: el método de pago seleccionado sigue el color de acento del enlace de pago**\
  En un enlace de pago, el borde del método de pago seleccionado tomaba el color de acento del estilo de SDK Checkout en lugar del publicado para el enlace de pago en Checkout Builder. Ahora la página del enlace de pago le entrega su color de acento al SDK, que lo usa en lugar del de SDK Checkout. Los enlaces de pago sin estilo publicado, y cualquier otra integración, mantienen el comportamiento actual. No se requieren cambios en las integraciones de los comercios.

## v1.11.10

*19 de septiembre de 2026*

**Apple Pay**

* CHANGED **Los teléfonos Android ya no cargan recursos de Apple Pay**\
  Los teléfonos Android ahora omiten Apple Pay de inmediato: el SDK ya no descarga el código del botón de Apple Pay ni el SDK de Apple en ellos, y ya no solicita la configuración de Apple Pay, incluso en los flujos de botones externos. En esos teléfonos, Apple respondía que el dispositivo no puede pagar en casi todas las sesiones de producción, y esas descargas tardaban hasta varios segundos en conexiones lentas, compitiendo con los demás botones de billeteras. Como Apple Pay ya no ocupa el espacio exprés en esos teléfonos, Google Pay se muestra como botón exprés en lugar de aparecer en la lista de métodos de pago. Como consecuencia, los pocos teléfonos Android en los que Apple permitía pagar mediante un código QR ya no muestran el botón de Apple Pay. Las tabletas Android y los navegadores de escritorio siguen consultando a Apple y lo siguen mostrando donde Apple lo permite, al igual que cualquier página que ya cargue por sí misma el SDK de Apple.

## v1.11.9

*18 de septiembre de 2026*

**PayPal**

* FIXED **PayPal Enrollment en JS SDK v6**\
  El botón de inscripción de PayPal (bóveda y acuerdo de facturación) ahora usa el JS SDK v6 de PayPal, el mismo que el botón de pago de PayPal, por lo que un checkout ya no descarga dos SDK de PayPal y el botón se renderiza directamente en la página en lugar de dentro de un iframe.

* FIXED **Reintento de PayPal después de un inicio fallido**\
  Cuando la ventana de checkout de PayPal no se abría, hacer clic de nuevo en el botón creaba un segundo pago para la misma compra. Ahora el reintento reutiliza el pago que ya se había creado en lugar de crear otro.

**Core SDK**

* CHANGED **El botón de PayPal Enrollment obtiene su configuración antes en el checkout Full**\
  Los checkouts Full y Seamless Full solicitan algunas configuraciones de métodos de pago de forma anticipada, antes de que se conozca la lista de métodos de pago, para que los botones exprés que las necesitan no esperen. La solicitud anticipada de PayPal casi nunca se usaba, porque muy pocos checkouts habilitan el botón estándar de PayPal. Se reemplaza por una solicitud anticipada de PayPal Enrollment, que se habilita con mucha más frecuencia.

* CHANGED **El botón de Google Pay verifica la elegibilidad antes**\
  Los checkouts Full y Seamless Full y los botones externos inician la verificación de elegibilidad de Google Pay en cuanto el checkout sabe que Google Pay está habilitado, en lugar de después de que se renderiza la lista de métodos de pago, por lo que el botón aparece antes. Los compradores que no pueden usar Google Pay ven exactamente lo mismo que antes.

* CHANGED **Los botones exprés cargan más rápido dentro de las apps de Instagram y Facebook en Android**\
  Dentro de las apps de Instagram y Facebook en Android, los scripts de prevención de fraude que los botones exprés (PayPal, Google Pay, Apple Pay, Samsung Pay, Revolut Pay) y el método de pago preseleccionado inician mientras carga el checkout ahora inician cuando esos botones terminaron de cargar, o como máximo después de 3 segundos. Los botones aparecen antes en estos dispositivos y es menos probable que el tiempo de espera de carga los oculte. Si el comprador paga antes de que los scripts hayan iniciado, estos inician en ese momento y el pago espera un poco más los datos antifraude. Los demás navegadores no cambian.

**Apple Pay**

* CHANGED **Los dispositivos que no pueden pagar con Apple Pay ya no solicitan su configuración**\
  El botón de Apple Pay ahora le pregunta a Apple si el dispositivo puede pagar antes de solicitar la configuración de Apple Pay, en lugar de después. En los dispositivos donde la respuesta es no (la mayoría de los teléfonos Android), el SDK omite la solicitud de configuración, la sesión de Apple Pay del backend asociada y la solicitud del monto, lo que libera tiempo de red y del hilo principal para los demás botones de billeteras. Las solicitudes de configuración anticipadas de los checkouts Full siguen la misma regla. Todos los dispositivos que hoy muestran el botón de Apple Pay siguen mostrándolo, incluidos los navegadores de escritorio de terceros y los dispositivos Android donde Apple permite pagar mediante un código QR.

**Payment Methods**

* FIXED **El formulario de correo de Click to Pay está totalmente traducido**\
  Después de la corrección del separador "or" en la 1.11.8, el resto del formulario de correo de Click to Pay seguía en inglés en árabe, alemán, francés, italiano, japonés, coreano, neerlandés, polaco, ruso, sueco, turco, vietnamita y chino (simplificado y tradicional): las dos etiquetas de opción, el texto de ayuda "How does Click to Pay use my information?" y su tooltip, y la casilla "add this card to Click to Pay" ahora están traducidos. Filipino, indonesio, malayo y tailandés no tenían traducción para este formulario y lo mostraban en inglés; ahora también están traducidos. El mensaje de error de la transacción también está traducido en coreano y corregido en japonés y turco, donde decía por error que el método de pago no se podía eliminar.

**Rendimiento**

* CHANGED **Los checkouts con una sesión solicitan los datos de país una sola vez**\
  Cada montaje del checkout solicitaba los datos de país dos veces cuando tenía una sesión de checkout: una por país y otra por sesión. Ambas respuestas incluyen la misma lista de países, enlaces y datos de métodos de pago, y la de sesión también incluye los tipos de documento propios del comercio, por lo que el SDK ahora solicita solo por sesión y mantiene la solicitud por país para los flujos sin sesión. Los prefijos telefónicos, los tipos de documento, los enlaces de privacidad y las marcas de tarjeta provienen de esa única respuesta en los formularios de tarjeta, cliente, Click to Pay y PayPal Braintree.

## v1.11.8

*18 de septiembre de 2026*

**Payment Methods**

* FIXED **Click to Pay muestra el separador "or" en el idioma del comprador**\
  El separador entre "access my linked cards" y "enter the card manually" en las pantallas de correo y de código de un solo uso de Click to Pay decía "Ó" en portugués y español, y se quedaba en inglés en otros catorce idiomas. Ahora dice "OU" en portugués, "O" en español, y está traducido en árabe, alemán, francés, italiano, japonés, coreano, neerlandés, polaco, ruso, sueco, turco, vietnamita y chino.

## v1.11.7

*17 de septiembre de 2026*

**Core SDK**

* CHANGED **Mejoras en el registro interno**\
  Mejores registros internos de rendimiento para los botones exprés. Sin cambios funcionales ni de API.

## v1.11.6

*17 de septiembre de 2026*

**Core SDK**

* CHANGED **Los eventos del SDK incluyen la versión pública del SDK y la raíz de la cadena de reintentos desde el primer intento**\
  Cada evento del SDK ahora incluye `sdk_version_external` (la versión pública que instala el comercio) junto a la `sdk_version` interna, y `connection_effective_type` cuando el navegador lo expone. `original_checkout_session` se envía desde el primer intento, igual a la propia sesión de checkout hasta que un reintento la vincula con su raíz. Iniciar un nuevo checkout en la misma página ya no hereda la cadena de reintentos anterior, y la página de estado conserva `retry_count` y `payment_method.saved` de la sesión que muestra.

* FIXED **checkout.abandoned envía los atributos que requiere su contrato**\
  `checkout.abandoned` ahora incluye `reason` (`tab_switch` cuando la página se oculta, `close_button` cuando se cierra la inscripción), `elapsed_ms` desde `checkout.opened` y los contadores de interacción. `fields_errored` se emite junto con los demás contadores en `checkout.abandoned` y `checkout.completed`, y cuenta los errores de validación de campos mostrados durante el checkout.

## v1.11.4

*16 de septiembre de 2026*

**Checkout**

* ADDED **Eventos de carga granulares para el renderizado progresivo del checkout**\
  El callback onLoading ahora informa dos nuevos hitos: PAYMENT\_LIST\_RENDERED en cuanto la lista de métodos de pago está lista, y ALL\_PAYMENT\_METHODS\_RENDERED una vez que todos los botones exprés visibles sin desplazarse han cargado o fallado. Los integradores pueden quitar su skeleton cuando la lista está lista, en lugar de esperar al botón exprés más lento o a su tiempo de espera de 5 s. SEAMLESS\_LIST\_BUTTONS no cambia, por lo que las integraciones existentes no se ven afectadas. Al eliminar un método de pago guardado, los tres hitos vuelven al estado de carga mientras se recarga la lista.

## v1.11.3

*15 de septiembre de 2026*

**Core SDK**

* FIXED **El texto de autorización bajo el botón de pago único se mantiene con el método seleccionado**\
  Con el botón de pago de Yuno en posición FLOATING o STICKY, el texto de autorización de credenciales almacenadas que se muestra debajo del botón podía desaparecer o pertenecer a otro método después de que el comprador visitara más de un método de pago: un formulario que quedaba montado en la lista de métodos de pago publicaba su propio estado de guardado bajo el método recién seleccionado. Ahora cada formulario publica solo bajo el método con el que se abrió.

## v1.11.2

*15 de septiembre de 2026*

**Card Payments**

* FIXED **Respetar la tecla Siguiente del teclado en los campos seguros del formulario de tarjeta**\
  Al presionar Siguiente en el teclado móvil, el foco ahora avanza por los campos seguros de la tarjeta y, después del último, pasa a Cardholder Name, tanto en el formulario de tarjeta completo como en el formulario de campos seguros divididos, para todas las cuentas, incluidas las que tienen desactivado el avance automático de campos.

* CHANGED **Cargar el formulario de tarjeta desplegado sin esperar los datos del cliente**\
  El formulario de tarjeta desplegado en la lista de métodos de pago ahora comienza a cargar sus campos seguros de tarjeta en cuanto se renderiza, en lugar de esperar las solicitudes de emisores, datos de país y cuotas que alimentan los campos del cliente. Un placeholder ocupa el lugar de los campos del cliente hasta que llegan esos datos; luego los campos aparecen con el país del teléfono y del documento ya completados, y los campos de tarjeta conservan lo que el comprador ya escribió. Hasta que se muestran los campos del cliente, el formulario se informa como no válido. Un pago iniciado antes de que lleguen los datos mantiene el cargador visible (emite `onLoading` con `DOCUMENT`), espera los datos y los campos de tarjeta, y luego ejecuta la validación normal. No se requieren cambios en las integraciones de los comercios.

**Core SDK**

* ADDED **Texto de autorización contextual para métodos de pago almacenados**\
  Las tarjetas y los demás métodos de pago que no son de débito directo ahora renderizan el texto de autorización de credenciales almacenadas enviado por el backend (localizado y con el nombre comercial del comercio). El texto de pago y guardado (`mandate_type` RECURRENT) se muestra una vez que el método se va a almacenar: el comprador marca "save" o el comercio fuerza `card.vaultOnSuccess`. Los textos de inscripción y suscripción (`mandate_type` ENROLLMENT / SUBSCRIPTION) los define el backend a partir de la sesión y se renderizan a medida que llegan, al igual que cualquier escenario futuro; un texto así mantiene el formulario del método de pago en pantalla incluso cuando el comprador no tiene nada más que completar. El texto es propiedad de Yuno y sigue al botón de pago de Yuno: con `yuno_pay_button_position` ACCORDION se ubica justo debajo del botón en línea, con FLOATING o STICKY se mueve debajo del botón de pago único (encima de la insignia Powered by Yuno), y con un botón renderizado por el comercio se queda al final del formulario del método de pago. Los mandatos de débito directo mantienen el texto de su esquema dentro del formulario. Las billeteras nunca lo muestran.

* CHANGED **Botones exprés más rápidos en el checkout Full**\
  Los checkouts Full y Seamless Full ahora solicitan la configuración de cada método de pago habilitado en cuanto se conoce la lista de métodos de pago, en paralelo con la llamada de ajustes inicial, en lugar de un método a la vez después del primer renderizado. Los botones exprés (Apple Pay, Google Pay, PayPal, PayPal enrollment, Samsung Pay, Revolut Pay, PayPal Braintree), Click to Pay y la verificación 3DS de tarjeta encuentran su configuración ya cargada, lo que elimina un viaje de ida y vuelta completo de red del montaje en conexiones lentas. No se requieren cambios en las integraciones de los comercios.

* CHANGED **Arranque del SDK más liviano: la detección del navegador pasa al servidor**\
  El SDK ya no incluye ni ejecuta en cada carga de página un analizador de user-agent para describir el navegador, el sistema operativo y el dispositivo en sus eventos de monitoreo; ahora el backend de Yuno obtiene esa información de la propia solicitud, con unas pocas pistas de navigator enviadas para mantener la misma precisión (Brave, iPadOS en modo escritorio, indicador de móvil). El bundle se reduce en aproximadamente 8 KB comprimido con gzip y el arranque del SDK hace menos trabajo en dispositivos lentos. No se requieren cambios en las integraciones.

**PayPal**

* FIXED **Compatibilidad con PayPal JS SDK v6**\
  El botón de PayPal ahora usa el JS SDK v6 de PayPal, que renderiza el botón directamente en la página en lugar de dentro de un iframe, por lo que aparece antes y se vuelve a renderizar al instante. Las integraciones de sandbox ahora cargan PayPal desde `www.sandbox.paypal.com` en lugar de `www.paypal.com`; si tu página define un `script-src` estricto, permite ambos hosts.

## v1.11.1

*14 de septiembre de 2026*

**Card Payments**

* CHANGED **Iframes de campos de tarjeta más rápidos y livianos**\
  Los iframes del formulario de tarjeta y de Secure Fields ahora se comunican con el SDK a través del puente entre frames propio del SDK en lugar de la biblioteca zoid, por lo que cada iframe de tarjeta incluye unos 100 KB menos de JavaScript y se renderiza notablemente más rápido en dispositivos y redes lentos. No se requieren cambios en las integraciones.

## v1.11.0

*12 de septiembre de 2026*

**Core SDK**

* FIXED **Hosts estáticos regionales: los chunks y los iframes de tarjeta siguen el host desde el que se cargó el SDK**\
  Hasta ahora, el bundle servido desde `sdk-web.<region>.y.uno` (UE: `sdk-web.prod.eu.y.uno`, MENA: `sdk-web.mena.staging.y.uno`) seguía obteniendo cada chunk diferido del host de EE. UU. para el que fue compilado y ambos iframes de tarjeta desde `sdk-web-card.prod.y.uno`. Ahora el SDK registra el host desde el que realmente se cargó `main.js` y, cuando es un host estático de Yuno distinto del compilado, sirve los chunks diferidos desde ese mismo directorio y carga los iframes del formulario de tarjeta y de los campos seguros desde el host `sdk-web-card.<region>` correspondiente. La misma compilación funciona en todos los buckets regionales, por lo que no se necesitan variantes de compilación ni cambios de infraestructura. Los overrides `apiUrl` / `assetUrl` del comercio mantienen la precedencia, y un bundle alojado por cuenta propia en un dominio que no es de Yuno se comporta como antes. No se requieren cambios en las integraciones de los comercios.

## v1.10.37

*10 de noviembre de 2026*

**Core SDK**

* FIXED **El CVV de la tarjeta guardada muestra su propia etiqueta y la fuente del comercio**\
  En el formulario de tarjeta guardada, el campo del código de seguridad mostraba el título de la sección de la tarjeta (por ejemplo "Información de la tarjeta") en lugar de "CVV" cuando el formulario no estaba en la variante compacta. Ahora usa el mismo texto que el formulario de tarjeta nueva. Los campos de código de seguridad y PIN de la tarjeta del formulario de tarjeta guardada también cargan las fuentes pasadas en `card.fonts`, por lo que ya no vuelven a la fuente predeterminada del navegador.

## v1.10.36

*21 de octubre de 2026*

**Core SDK**

* CHANGED **La disponibilidad de Apple Pay siempre usa la verificación de capacidades**\
  El botón de Apple Pay y `isPaymentMethodAvailable` ya no leen la configuración `apple_pay_capabilities_enabled`: cuando la API `applePayCapabilities` de Apple está disponible y se conoce el identificador del comercio, esta decide si se muestra el botón, como ya hacía con la configuración activada para todos los comercios. Sin la API, o cuando la llamada falla, el SDK sigue recurriendo a `canMakePayments()`. Sin cambios visibles.

## v1.10.35

*19 de octubre de 2026*

**Core SDK**

* ADDED **Verifica si un método de pago se mostrará antes de listarlo**\
  El nuevo `yuno.isPaymentMethodAvailable({ paymentMethodType, checkoutSession? })` se resuelve en `true` o `false` para cualquier tipo de método de pago, con la misma decisión que toma el SDK antes de mostrar ese método para la sesión de checkout: el método debe estar habilitado para la sesión y, para los métodos que el SDK verifica primero contra el dispositivo o el navegador, ejecuta esa misma verificación (por ejemplo Apple Pay en el navegador y en el dispositivo, o `isReadyToPay` de Google Pay). Los comercios que dibujan su propia lista de métodos de pago (Lite, Seamless Lite, botones exprés dentro de su propia lista) pueden llamarlo después de `startCheckout`, o pasar `checkoutSession`, y ocultar los métodos que no se renderizarían. Nunca se rechaza: cuando la sesión no tiene métodos de pago, la solicitud falla o falla una verificación del dispositivo, se resuelve en `false`.

**Apple Pay**

* FIXED **Apple Pay espera el script de Apple cuando todavía se está cargando**\
  Cuando el script de Apple Pay de Apple ya estaba en la página pero aún se estaba descargando (un segundo botón de Apple Pay, o `isPaymentMethodAvailable` llamado justo antes de montar), el SDK no lo esperaba y el botón podía no renderizarse. Ahora espera la descarga en curso, como lo hace Web SDK 1.11.

## v1.10.34

*16 de octubre de 2026*

**Payment Actions**

* FIXED **Corrige el cargador después de la configuración de 3DS**\
  Cuando un pago termina en el paso de configuración de 3DS y el comercio gestiona el estado del pago (`showPaymentStatus: false`), el SDK ahora oculta su cargador en cuanto entrega el resultado. Antes, el cargador permanecía en pantalla durante aproximadamente un minuto y luego mostraba un error "Transaction failed", aunque el resultado ya había llegado al comercio. Esto afectaba las autenticaciones solo 3DS y los pagos con tarjeta rechazados durante la autenticación 3DS.

## v1.10.33

*16 de octubre de 2026*

**Core SDK**

* ADDED **Descripción del método de pago desde Checkout Builder**\
  En la lista de métodos de pago del checkout Full, la descripción que el comercio define para un método de pago en Checkout Builder (`custom_description`) se muestra como una segunda línea gris debajo de su nombre. El texto se muestra completo, se ajusta a tantas líneas como necesite y conserva sus saltos de línea. Los métodos sin descripción, y las tarjetas o cuentas guardadas, se renderizan como antes.

## v1.10.32

*14 de octubre de 2026*

**Card Payments**

* FIXED **RTL en hebreo y persa en el formulario de tarjeta**\
  Los campos seguros del formulario de tarjeta ahora se renderizan de derecha a izquierda para hebreo y persa, en línea con la dirección del shell del checkout.

## v1.10.30

*8 de octubre de 2026*

**Core SDK**

* ADDED **Los eventos del SDK informan cuánto debe desplazarse la página para llegar al botón de pago del formulario abierto**\
  `checkout.completed` y `checkout.abandoned` ahora incluyen `scroll_needed_px`, cuánto debe desplazarse la página desde su parte superior para que el botón de pago del formulario del método de pago abierto quede en pantalla, y `viewport_height_px` como contexto. El valor es una medición de diseño: es el mismo dondequiera que el comprador se haya desplazado, y un formulario más corto lo reduce. Se lee cuando se abre un formulario (al seleccionar en la lista desplegada, cuando el formulario se muestra en los modos de renderizado modal y de elemento), de nuevo cada vez que el área del SDK o el modal del SDK cambian de tamaño mientras carga el formulario, cuando el comprador confirma el pago y cuando se envía el evento; una lectura que encuentra el botón de pago siempre prevalece y una que no lo encuentra nunca la reemplaza, por lo que el cargador de pago no la sobrescribe. Apunta al botón de pago visible del SDK: el botón de pago del método seleccionado en el acordeón, el botón de pago único, el botón de pago del pie del modal o el botón de envío del formulario, contando el desplazamiento que queda dentro de un modal con scroll o una superposición modal. Un botón de pago fijo informa 0. Cuando el comercio renderiza su propio botón, se usa como sustituto la parte inferior de lo que dibujó el SDK. No se envía nada cuando no se abrió ningún formulario. El existente `scroll_distance_px` no cambia.

## v1.10.29

*6 de octubre de 2026*

**Lite Web SDK**

* FIXED **El formulario de inscripción sigue los tipos de documento permitidos**\
  El formulario de inscripción ahora lista solo los tipos de documento habilitados para el país en Checkout Builder (Payment method settings, Allowed Document Types). Antes, la inscripción con una sesión de cliente siempre listaba todos los tipos de documento del país, mientras que los pagos con una sesión de checkout ya seguían la configuración publicada.

## v1.10.28

*5 de octubre de 2026*

**Core SDK**

* ADDED **Analítica del consentimiento de débito directo**\
  El SDK ahora informa el paso de autorización de débito directo: cuando se muestra el texto del mandato, cuando el comprador lo acepta y, donde un esquema o un comercio exige una casilla explícita, cada marca y cada envío bloqueado. Cada evento incluye la versión de la redacción que se mostró, de modo que el abandono en el paso de consentimiento se pueda medir por plantilla. Los eventos en sí no transportan ninguna redacción.

## v1.10.26

*1 de octubre de 2026*

**Core SDK**

* ADDED **El token de un solo uso ahora incluye el nombre del banco de ACH**\
  Para una transferencia bancaria ACH, el segundo argumento de los callbacks `createPayment` y `yunoCreatePayment` ahora incluye `bank_transfer.bank_name`, el nombre del banco que Yuno deriva del número de ruta, o el valor enviado en la solicitud del token. Solo se expone el nombre del banco: los números de cuenta y de ruta nunca se devuelven en el token. Los tokens de otros métodos de pago no incluyen la clave. El campo está tipado en `OneTimeToken` (`bank_transfer?: { bank_name?: string }`), por lo que las integraciones con TypeScript lo leen sin un cast.

## v1.10.25

*24 de septiembre de 2026*

**Core SDK**

* FIXED **`three_ds.completed` ahora informa el resultado de 3DS en lugar del resultado del pago**\
  Cuando la autenticación 3DS tiene éxito y luego el adquirente rechaza el pago, `three_ds.completed` informa `result: authenticated` y el rechazo queda en `payment.resolved`. El resultado se lee de la última transacción del pago que el SDK ya recibe (su proveedor y código de respuesta). Cuando esa transacción no está disponible, por ejemplo cuando el estado final llega por el websocket, el resultado sigue el resultado del pago como antes. Límite conocido: los proveedores que autentican y autorizan en una sola transacción y no exponen un código de respuesta de 3DS, hoy Adyen (unas 200 sesiones 3DS de Adyen por semana), informan sus rechazos de 3DS como `authenticated` hasta que.

## v1.10.24

*23 de septiembre de 2026*

**PayPal**

* ADDED **Venmo se renderiza en sandbox para testers fuera de EE. UU.**\
  Con credenciales de sandbox, el SDK ahora carga el PayPal JS SDK con `buyer-country=US` siempre que ENABLE\_FUNDING del comercio incluya `venmo`, como lo exige la guía de pruebas de Venmo de PayPal, para que QA fuera de EE. UU. vea el botón de Venmo. Las compilaciones de producción nunca lo envían.

## v1.10.23

*18 de septiembre de 2026*

**Payment Methods**

* FIXED **Click to Pay muestra el separador "or" en el idioma del comprador**\
  El separador entre "access my linked cards" y "enter the card manually" en las pantallas de correo y de código de un solo uso de Click to Pay decía "Ó" en portugués y español, y se quedaba en inglés en otros catorce idiomas. Ahora dice "OU" en portugués, "O" en español, y está traducido en árabe, alemán, francés, italiano, japonés, coreano, neerlandés, polaco, ruso, sueco, turco, vietnamita y chino.

## v1.10.22

*17 de septiembre de 2026*

**PayPal**

* FIXED **El contenedor del botón de PayPal crece con los botones renderizados**\
  Los contenedores de los botones de PayPal, PayPal enrollment y PayPal Braintree ahora crecen con los botones que PayPal decide renderizar (por ejemplo PayPal + Venmo + Pay Later) en lugar de superponerse al contenido de abajo. Con un solo botón no cambia nada. Se agregaron los nombres de clase estables `__wrapper` y `__loading` para el estilo del comercio.

* ADDED **Compatibilidad con enable-funding de PayPal (Venmo)**\
  El SDK ahora lee el parámetro ENABLE\_FUNDING de la configuración del proveedor del comercio y lo pasa como enable-funding al cargar el PayPal JS SDK (flujos de botón e inscripción), para que fuentes de financiamiento como Venmo puedan renderizarse.

## v1.10.20

*15 de septiembre de 2026*

**Core SDK**

* FIXED **El texto de autorización bajo el botón de pago único se mantiene con el método seleccionado**\
  Con el botón de pago de Yuno en posición FLOATING o STICKY, el texto de autorización de credenciales almacenadas que se muestra debajo del botón podía desaparecer o pertenecer a otro método después de que el comprador visitara más de un método de pago: un formulario que quedaba montado en la lista de métodos de pago publicaba su propio estado de guardado bajo el método recién seleccionado. Ahora cada formulario publica solo el texto del método con el que se abrió, y solo mientras ese método está seleccionado.

## v1.10.19

*15 de septiembre de 2026*

**Core SDK**

* ADDED **Texto de autorización contextual para métodos de pago almacenados**\
  Las tarjetas y los demás métodos de pago que no son de débito directo ahora renderizan el texto de autorización de credenciales almacenadas enviado por el backend (localizado y con el nombre comercial del comercio). El texto de pago y guardado (`mandate_type` RECURRENT) se muestra una vez que el método se va a almacenar: el comprador marca "save" o el comercio fuerza `card.vaultOnSuccess`. Los textos de inscripción y suscripción (`mandate_type` ENROLLMENT / SUBSCRIPTION) los define el backend a partir de la sesión y se renderizan a medida que llegan, al igual que cualquier escenario futuro; un texto así mantiene el formulario del método de pago en pantalla incluso cuando el comprador no tiene nada más que completar. El texto es propiedad de Yuno y sigue al botón de pago de Yuno: con `yuno_pay_button_position` ACCORDION se ubica justo debajo del botón en línea, con FLOATING o STICKY se mueve debajo del botón de pago único (encima de la insignia Powered by Yuno), y con un botón renderizado por el comercio se queda al final del formulario del método de pago. Los mandatos de débito directo mantienen el texto de su esquema dentro del formulario. Las billeteras nunca lo muestran.

## v1.10.18

*14 de septiembre de 2026*

**Card Payments**

* FIXED **Respetar la tecla Siguiente del teclado en los campos seguros del formulario de tarjeta**\
  Al presionar Siguiente en el teclado móvil, el foco ahora avanza por los campos seguros de la tarjeta y, después del último, pasa a Cardholder Name, tanto en el formulario de tarjeta completo como en el formulario de campos seguros divididos, para todas las cuentas, incluidas las que tienen desactivado el avance automático de campos.

## v1.10.17

*10 de septiembre de 2026*

**Payment Methods**

* FIXED **Corrige que la lista expandida de métodos de pago no preseleccionaba nada para compradores recurrentes**\
  Cuando la bandera `preferred` caía en un método renderizado como exprés (PayPal, Apple Pay, Google Pay) y la lista de radios tenía más de una fila, no se preseleccionaba ningún método de pago y el comprador tenía que elegir uno manualmente. La regla del único método regular ahora cuenta tipos de método distintos en lugar de filas, por lo que una tarjeta guardada y la fila de tarjeta nueva se agrupan en un solo método Card y se selecciona automáticamente la primera fila de tarjeta. Los botones exprés pasados a la lista de radios por el apilamiento horizontal ya no alteran el conteo, y un único botón exprés pasado a la lista se sigue preseleccionando como antes. Los checkouts que ofrecen varios métodos de pago distintos siguen requiriendo una selección manual, y un botón exprés preferido que nunca termina de renderizarse sigue sin seleccionarse automáticamente.

## v1.10.16

*6 de septiembre de 2026*

**Lite Web SDK**

* FIXED **La pantalla OTP de inscripción muestra la marca del método que se está inscribiendo**\
  El paso OTP de una inscripción siempre renderizaba el logo y el título de DaviPlata, sin importar qué método de pago se estuviera inscribiendo: una inscripción ACH a través de Stripe mostraba un encabezado de DaviPlata. Ahora el encabezado usa el ícono y el nombre que trae la propia inscripción, por lo que cada método muestra su propia marca, y recurre al título OTP genérico cuando la inscripción no tiene ninguno de los dos. Las inscripciones de DaviPlata mantienen el encabezado que tenían.

**Core SDK**

* FIXED **Los campos de tipo de cuenta y tipo de titular de la cuenta de ACH ofrecen sus opciones durante la inscripción**\
  Ambos campos leen las opciones de su lista desplegable del objeto `ui` del backend, y el flujo de inscripción nunca ponía ese objeto en el store. Los dos selectores se renderizaban vacíos, por lo que un cliente que inscribía una cuenta bancaria ACH no podía elegir un tipo de cuenta y no podía terminar el formulario. La respuesta de inscripción ya incluye el objeto `ui`, y ahora llega al store, lo que además permite que las etiquetas, los placeholders y los textos de error definidos por el backend se apliquen al resto del formulario de inscripción.

## v1.10.15

*5 de septiembre de 2026*

**Fraud & Risk**

* ADDED **Prefijo configurable por el comercio para el session\_id de ThreatMetrix en Cielo CyberSource**\
  El parámetro de conexión `FINGERPRINT_PREFIX` se antepone solo al session\_id de la URL del script de ThreatMetrix, mientras que el id de huella digital del dispositivo informado a Yuno sigue siendo el session id sin prefijo.

**Checkout**

* FIXED **Google Pay respeta `showPaymentStatus` cuando el pago falla**\
  La ruta de error de `completeGooglePayPayment` tenía fija la pantalla de estado, por lo que los comercios con `showPaymentStatus: false` aun así recibían la pantalla de página completa "Transaction failed" del SDK sobre su propia interfaz. Ahora respeta la bandera, de forma coherente con la ruta de acción de pago.

## v1.10.14

*4 de septiembre de 2026*

**Revolut Pay**

* FIXED **Corrige la expiración tardía de la autorización de Revolut Pay**\
  Cuando un comprador cerraba el widget de Revolut Pay mientras un desafío de autenticación aún estaba en curso, el SDK expiraba el pago de inmediato, y una autorización que Revolut completaba después no se podía aplicar, dejando fondos retenidos sin un pago visible. Ahora el SDK mantiene el pago abierto en esas cancelaciones para que una autorización tardía se refleje correctamente.

## v1.10.13

*3 de septiembre de 2026*

**Google Pay**

* FIXED **Mejor manejo del doble toque en Google Pay**\
  Un segundo toque rápido en el botón de Google Pay ahora se ignora mientras la hoja de pago está cargando, y el SDK ya no recarga la página del comercio en ese caso.

**Lite Web SDK**

* ADDED **Renderizado y personalización del elemento de PayPal Enrollment**\
  La inscripción de PayPal en `mountEnrollmentLite` ahora admite `renderMode.type: 'element'`, muestra un skeleton de carga mientras el botón carga y acepta `externalButtons.paypal` para personalizar el botón.

**Payment Actions**

* FIXED **Las redirecciones del comercio después de 3DS ya no se cancelan**\
  Mientras un desafío 3DS está abierto, el SDK agrega una entrada al historial del navegador para que el botón de retroceso pueda cancelar el pago. Quitaba esa entrada justo después de avisarle al comercio que el pago había terminado, lo que cancelaba cualquier redirección que el comercio iniciara desde `yunoPaymentResult` o desde un botón de la pantalla de resultado y dejaba al comprador en el cargador. Ahora la entrada se quita justo antes de notificar al comercio, por lo que la redirección se completa. El retroceso del navegador sigue cancelando el desafío como antes.

## v1.10.12

*2 de septiembre de 2026*

**Core SDK**

* ADDED **Autorización de débito directo y guardado para pagos futuros**\
  Los métodos de pago de débito directo (ACH, SEPA, Bacs, PAD, iDEAL) ahora renderizan el texto de autorización del mandato enviado por el backend, alternando entre los textos de pago único y recurrente según el comprador opte por guardar, con la casilla de aceptación obligatoria donde el esquema lo exige (SEPA / iDEAL), y envían la evidencia de aceptación del mandato en las solicitudes del token de un solo uso y de inscripción. Agrega la opción `savePaymentMethodEnabled` a `startCheckout`: cuando el comercio la habilita y el método admite guardado, el checkout renderiza una casilla "Save payment method for future payments" y la elección del comprador viaja como `vault_on_success` (se envía solo cuando está marcada). Desactivada por defecto; la tarjeta mantiene su propia configuración `card.cardSaveEnable` / `card.vaultOnSuccess`.

* ADDED **Atribución del plugin en cada evento del SDK**\
  `Yuno.initialize` acepta un bloque opcional `plugin` que identifica la plataforma de comercio en la que está integrado el SDK (`vtex`, `shopify`, `magento`, `woocommerce`, `prestashop` u `other`), junto con la versión propia del plugin y la versión de la plataforma anfitriona del comercio. Cuando está presente, cada evento que emite el SDK lleva `plugin_platform`, `plugin_version` y `host_platform_version` en el sobre, y `application` informa `plugin` en lugar de `sdk`. Esto permite dividir las vistas existentes de embudo, latencia y pruebas A/B por plataforma de comercio sin agregar ni un solo evento nuevo. Una integración directa del comercio omite el bloque y no cambia nada: los tres atributos son nulos y `application` conserva su valor actual.

## v1.10.11

*1 de septiembre de 2026*

**Checkout**

* CHANGED **Detección de capacidades de Apple Pay reforzada para Safari antiguo**\
  `applePayCapabilities()` ahora se detecta como función antes de usarse (la API solo existe en Safari en iOS 18 / macOS Sequoia y posteriores), y una llamada de capacidades fallida recurre a la verificación heredada `canMakePayments()` en lugar de ocultar el botón de Apple Pay. Una llamada exitosa que informa que no hay ninguna tarjeta en la billetera sigue ocultando el botón. Esto hace seguro habilitar por defecto la detección basada en capacidades para todos los comercios.

**Core SDK**

* ADDED **onChange informa si el formulario de pago está completo**\
  Los comercios que ocultan el botón de pago del SDK con `showPayButton: false` y renderizan el suyo ahora pueden saber cuándo el formulario está listo para enviarse. `onChange` informa `{ form: { isValid } }` cada vez que cambia, y cubre todos los campos obligatorios, incluidos los campos de tarjeta que el SDK renderiza en sus iframes seguros. Está disponible en `startCheckout` y en `mountEnrollmentLite`, y funciona para formularios de tarjeta, tarjeta guardada y métodos de pago alternativos.

* FIXED **Solo se envía el método de pago seleccionado, y el estado de carga siempre se cierra**\
  Cuando un cliente completaba un método de pago y luego cambiaba a otro, el SDK podía enviar ambos y crear más de un token de pago. Ahora solo se envía el método de pago que el cliente tiene seleccionado en ese momento. Además, cuando fallaba la creación del token en un método de pago alternativo, `onLoading` nunca informaba que había terminado, lo que dejaba a los comercios con un estado de carga que nunca se cerraba. El formulario del método de pago alternativo también dejaba activo su propio indicador de carga después del primer envío, por lo que cualquier código que lo leyera permanecía en estado de carga durante el resto de la sesión.

## v1.10.10

*31 de agosto de 2026*

**Core SDK**

* CHANGED **Eventos del SDK renombrados según la taxonomía de eventos**\
  Ahora cada evento del SDK usa su nombre de la taxonomía (`object.verb`): `checkoutSdk_started` pasa a ser `checkout.opened`, `payment_resolved` pasa a ser `payment.resolved`, los eventos por formulario se unifican en `form.viewed` / `form.submitted` / `form.closed` / `form.copied` con un atributo `form_type`, los eventos de las páginas de estado pasan a `result.viewed` / `result.returned`, y toda la familia `enroll*` pasa a los mismos eventos con `flow: enrollment`. Agrega los eventos que define la taxonomía y que antes no tenían equivalente: `payment_method.viewed` (con los motivos por los que un método ofrecido no se montó), `payment_method.saved` / `.deleted`, `payment.retried`, `installment.*`, `three_ds.*`, `wallet.*` para Apple Pay y Google Pay, y `field.*`. Los payloads de los eventos ahora incluyen los atributos dentro de `attributes`, junto con el productor y el número de secuencia que permiten medir la pérdida de eventos en el cliente.

* ADDED **Apilado configurable de los botones express**\
  Los botones express siguen el apilado elegido en el Checkout Builder: el horizontal mantiene la fila actual de hasta tres botones, y el vertical muestra cada botón express a todo el ancho, uno por línea, con el diseño anterior más corto y redondeado.

## v1.10.9

*27 de agosto de 2026*

**Checkout**

* CHANGED **Formularios compactos con tamaños equivalentes a los de Stripe**\
  Los campos de los formularios compactos ahora se muestran con una altura de 44px (el mínimo táctil de Apple HIG), con texto de entrada de 16px y etiquetas de 13px, y las secciones del formulario están separadas por 41px. El texto de entrada de 16px también evita que iOS Safari haga zoom automático en la página cuando un campo recibe el foco, incluidos los campos del número de tarjeta, la fecha de vencimiento y el CVV, y el divisor entre vencimiento y CVV ahora se muestra de 1px como cualquier otro borde.

* CHANGED **La fuente Inter predeterminada se carga como subconjuntos woff2 externos**\
  La hoja de estilos de la fuente predeterminada del checkout ahora hace referencia a archivos woff2 externos por subconjunto Unicode, en lugar de un único CSS en base64 de 584 KB, por lo que una carga en frío en latín descarga \~56 KB (-90%) y los demás alfabetos descargan su subconjunto bajo demanda. Sin cambios visuales.

**Fraud & Risk**

* ADDED **Compatibilidad con la huella digital de dispositivo de Accertify**\
  El SDK ahora carga la etiqueta de dispositivo de Accertify cuando hay una conexión de verificación de fraude de Accertify configurada, y envía el ID de dispositivo resultante junto con el pago. La URL de la etiqueta se lee de la conexión, por lo que se configura por comercio y por entorno en lugar de estar fija en el código. Si la etiqueta no carga o se agota el tiempo de espera, el pago continúa y no se envía ninguna entrada de dispositivo de Accertify.

**Payment Actions**

* ADDED **Bloque de enlaces de botones en las acciones de pago**\
  Las acciones de pago ahora pueden mostrar una fila de destinos para que el comprador elija, cada uno con su propio nombre e ícono. Flujos como UPI Autopay lo usan para ofrecer las aplicaciones en las que se puede completar el pago. Los destinos los envía el proveedor en cada transacción, y el bloque solo se muestra cuando la acción lo incluye.

* FIXED **Finalización del desafío 3DS embebido en marca blanca**\
  Cuando el SDK se inicializa con un `apiUrl` de marca blanca, el desafío 3DS embebido (`render_iframe`) se sirve desde el origen propio del comercio. Ahora el SDK acepta el resultado del desafío desde ese origen, por lo que el flujo de pago continúa después del desafío en lugar de quedarse en la pantalla de carga.

**Samsung Pay**

* ADDED **Botón de Samsung Pay en portugués mediante reemplazo de recurso según el idioma**\
  Cuando el idioma del checkout es portugués (pt/pt-BR), el botón express de Samsung Pay muestra un recurso en portugués alojado por Yuno en lugar del recurso en inglés alojado por Samsung. El recurso se precarga primero para que, si falla la carga, se use el recurso predeterminado de Samsung, y el reemplazo se aplica solo al botón de Samsung. Solución provisional hasta que Samsung publique un recurso localizado oficial en su CDN.

**Lite Web SDK**

* CHANGED **La inscripción envía cada campo de transferencia bancaria por separado**\
  La inscripción solo enviaba el número de cuenta, el nombre del beneficiario y el número de ruta cuando los tres estaban completos, por lo que los métodos que no piden número de ruta (SEPA Direct Debit) perdían los otros dos. Ahora cada campo se envía siempre que tenga un valor.

**Core SDK**

* FIXED **Los observadores de errores de scripts de terceros ya no reemplazan window\.onerror**\
  Los observadores de los scripts de antifraude y de Secure Card on File asignaban window\.onerror directamente, lo que reemplazaba cualquier controlador definido por la página del comercio y por otros módulos del SDK, por lo que sus errores del navegador no se reportaban. Ahora el SDK registra listeners del evento de error, y se conservan tanto el controlador del comercio como el reporte de errores propio del SDK.

## v1.10.8

*22 de agosto de 2026*

**Core SDK**

* ADDED **Botón de pago de Yuno**\
  Ahora el SDK puede mostrar su propio botón de pago, controlado por la configuración yuno\_pay\_button\_position: FLOATING lo ubica al final de la lista de métodos de pago, STICKY lo mantiene fijo en la parte inferior de la pantalla en móvil (y usa FLOATING en escritorio), y ACCORDION lo muestra dentro de cada método de pago. Una nueva opción stickyPayButton.lastElementSelector en startCheckout permite a los comercios indicar al SDK qué elemento debe recibir el espaciado para que la barra fija nunca tape el contenido de su página.

* CHANGED **Validación de formularios con respuesta en vivo**\
  Los formularios de pago ahora validan de forma continua mientras el cliente escribe, los errores aparecen solo después de salir de un campo, y los botones de pago se ven deshabilitados hasta que el formulario esté completo, aunque siguen siendo clicables para mostrar los errores pendientes.

**Google Pay**

* ADDED **La hoja de Google Pay ahora ofrece un selector de método de envío**\
  La hoja de pago de Google Pay puede mostrar los métodos de envío del comercio para que el comprador elija uno directamente en la hoja, con los montos actualizados en cada selección.

* ADDED **La hoja de pago de Google Pay ahora muestra el desglose de la orden**\
  Google Pay muestra en la hoja de pago el desglose de la orden por concepto (subtotal, envío, impuestos, descuentos) cuando la sesión de checkout incluye los elementos de resumen.

* ADDED **Google Pay notifica los cambios de dirección de envío en tiempo real**\
  Los comercios pueden registrar un callback onShippingAddressChanged para recibir la dirección de envío seleccionada en la hoja de Google Pay y devolver montos actualizados mientras el comprador completa su compra.

**Payment Actions**

* ADDED **Callbacks de envío para Apple Pay**\
  La hoja de Apple Pay ahora puede abrirse con tus opciones de entrega y el desglose de precios ya cargados, y avisarte cuando el cliente elige o cambia una dirección de envío. Cuando la sesión de checkout incluye `shipping_methods` o `summary_items`, la hoja los muestra tal cual: la primera opción de entrega queda preseleccionada, su desglose determina el total y tus etiquetas se muestran exactamente como las escribiste. Configura `externalButtons.onShippingAddressChanged` para que se llame con la dirección que expone la billetera (ciudad, estado, código postal y país) y responde con nuevos totales, nuevas opciones de entrega o un mensaje de error que rechace la dirección. El cambio entre opciones de entrega se responde desde la caché del propio SDK, por lo que tu controlador solo se llama cuando cambia la dirección, y la opción que eligió el cliente viaja con el token de un solo uso junto con la dirección de envío. Las sesiones de checkout sin estos campos y las integraciones sin el controlador se comportan exactamente como antes.

* FIXED **Recopilación de datos del dispositivo para 3DS de Worldpay**\
  Los pagos con tarjeta enrutados por el 3DS propio de Worldpay ahora ejecutan el paso de recopilación de datos del dispositivo y reportan la huella digital resultante al proveedor, de modo que el desafío de autenticación se comporte correctamente en lugar de degradarse en silencio. La misma corrección se aplica al flujo headless, y otros proveedores de 3DS ahora también reenvían la sesión de dispositivo que recopilan.

## v1.10.7

*19 de agosto de 2026*

**Installments**

* CHANGED **Avisar a los campos de la tarjeta cuando una conexión calcula las cuotas por tarjeta**\
  Los campos seguros de la tarjeta ahora reciben installments\_require\_full\_card desde el método de pago, por lo que esperan el número completo de la tarjeta antes de cotizar cuando una conexión enrutada calcula cada plazo según esa tarjeta exacta.

## v1.10.6

*19 de agosto de 2026*

**Card Payments**

* FIXED **Validación del número de tarjeta cuando la consulta de BIN es desconocida o falla**\
  Antes, una consulta de BIN desconocida o fallida omitía en silencio la validación de Luhn, lo que dejaba pasar a la tokenización números de tarjeta estructuralmente inválidos. Ahora el formulario de tarjeta valida de forma predeterminada, salvo que el backend indique explícitamente lo contrario.

**Click to Pay**

* FIXED **Se corrigió el tipo de tarjeta faltante en el token de un solo uso de Click to Pay**\
  Antes, las tarjetas inscritas que no eran duales dejaban vacío el cardType del OTT, por lo que el backend deducía el tipo a partir del BIN del token de red según la tabla card-iin, lo que clasifica mal las tarjetas de crédito como débito y hace que el adquirente rechace los pagos (kind DEBIT + installments, returnCode 54).

## v1.10.5

*14 de agosto de 2026*

**Métodos de pago alternativos**

* CHANGED **Se eliminó el encabezado predeterminado de los formularios de métodos de pago alternativos**\
  Los formularios de métodos de pago alternativos ya no muestran el encabezado "Ingresa los siguientes datos para continuar", lo que reduce el ruido visual. Los encabezados específicos de cada contexto, como el título de inscripción de NuPay, se siguen mostrando.

**Card Payments**

* FIXED **Se corrigieron los bordes de campo recortados y la animación de foco en el formulario de tarjeta**\
  Los bordes de los campos del formulario de tarjeta ya no se muestran cortados en algunos dispositivos móviles, y la animación de foco ya no se recorta.

* FIXED **Se corrigieron problemas con la selección de cuotas en el formulario de tarjeta**\
  La cuota seleccionada se conserva mientras se escribe en el formulario de tarjeta, y onInstallmentSelected vuelve a notificar la última selección al regresar al método de pago con tarjeta.

**Google Pay**

* FIXED **Mejor manejo del doble toque en Google Pay**\
  Se corrigió un problema por el cual tocar rápidamente dos veces el botón de Google Pay provocaba una recarga de la página mientras la hoja de pago estaba abierta, lo que impedía que la hoja completara el pago.

* FIXED **Se corrigió el estado hover atascado del botón de Google Pay**\
  Se corrigió que el botón de Google Pay se quedara en su estado hover gris en dispositivos táctiles después de abrir y cerrar la hoja de pago.

**Core SDK**

* CHANGED **Mejor rendimiento de carga del checkout**\
  Ahora el checkout muestra un esqueleto de carga en lugar de un espacio en blanco mientras se descargan sus recursos, y los botones de pago externos se muestran más rápido gracias a descargas más pequeñas y en paralelo. También corrige una condición de carrera que podía dejar vacío el menú desplegable del tipo de documento.

## v1.10.4

*10 de agosto de 2026*

**Core SDK**

* CHANGED **Carga más rápida de Lite y de los botones externos**\
  Los flujos Lite, Seamless Lite y de botones externos independientes ahora cargan más rápido: los recursos del SDK se descargan en paralelo con las primeras llamadas a la API y el montaje solo espera la solicitud de configuración, lo que reduce el tiempo para mostrar el formulario de pago y los botones express.

**Payment Actions**

* FIXED **Se corrigió showPaymentStatus en los fallos de pago**\
  Cuando showPaymentStatus está en false, el SDK ya no muestra a pantalla completa el mensaje "Transacción fallida" en fallos tempranos del pago (pago no encontrado o aún no procesado); en su lugar, el error se entrega mediante el callback onError.

## v1.10.3

*5 de agosto de 2026*

**Core SDK**

* CHANGED **Limpieza de eventos de analítica sin uso**\
  Elimina 17 métodos de emisión de analítica que no tenían ningún llamador (verificado contra develop y con una auditoría entre repositorios del iframe de la tarjeta y de los SDK móviles), incluidos los métodos `securityCodeForm.*` mal conectados que emitían `enrollStatus_pageViewed`. No cambia ningún evento emitido: todos los eventos que se disparan hoy siguen disparándose; `enrollPaymentMethodForm_submitted` conserva su emisor en línea activo y `payment_created` se mantiene reservado para el pipeline de auditoría.

* FIXED **Autocompletado del código de país del teléfono a partir del cliente**\
  Ahora el menú desplegable del código de país del teléfono en el formulario del checkout preselecciona el país que corresponde al prefijo telefónico del cliente enviado al crear la sesión, desambiguado por el país del cliente, en lugar de usar siempre el país de la sesión.

**Card Payments**

* ADDED **Evento onInstallmentSelected nulo cuando las cuotas dejan de estar disponibles**\
  Ahora el callback `onInstallmentSelected` se dispara con un payload `null` cuando las opciones de cuotas que ya se habían notificado dejan de estar disponibles, lo más común cuando el comprador cambia de una tarjeta con cuotas a una tarjeta sin ellas. El evento nulo solo se dispara si antes se notificó una selección real de cuotas; los formularios donde nunca hubo cuotas disponibles se mantienen en silencio. Además, las invocaciones del callback están envueltas para que un controlador del comercio que falle con `null` no pueda romper el formulario de tarjeta. Se aplica a los flujos de tarjeta nueva, campos seguros, tarjeta inscrita y Click to Pay.

* FIXED **Resolución del host de 3DS según el entorno**\
  Resuelve el host de sdk-3ds (challenge.html, session-id.html y el origen de los eventos de 3DS) a partir del entorno de ejecución del SDK, codificado en la clave pública de API, en lugar de fijarlo en el bundle durante la compilación. Un bundle compilado para un entorno (por ejemplo, prod) pero ejecutado en otro (por ejemplo, sandbox) enviaba un token de sesión de 3DS que no correspondía al entorno al host `sdk-3ds.<env>.y.uno` equivocado, donde el verificador de vinculación de sesión lo rechazaba con 403 Forbidden y el desafío nunca se cargaba. Los hosts de API y WebSocket ya se resuelven por entorno de esta forma; ahora el host de 3DS también. Es retrocompatible: un host concreto sin el marcador `_ENVIRONMENT_` se usa sin cambios.

## v1.10.2

*3 de agosto de 2026*

* CHANGED **Inscripción de PayPal**\
  Resuelve el estado del pago que se informa al comercio a partir del servidor, en lugar de asumir SUCCEEDED cuando PayPal aprueba, y evita el doble manejo de errores cuando la consulta del pago falla después de la aprobación: ahora la pantalla de error o el callback de error del comercio se dispara exactamente una vez, respetando `showPaymentStatus`.

## v1.10.1

*30 de julio de 2026*

**Core SDK**

* CHANGED **Carga más rápida del checkout completo**\
  Los checkouts Full y Seamless Full ahora cargan más rápido: los recursos del SDK y los scripts de los botones express se descargan en paralelo con las primeras llamadas a la API, lo que reduce el tiempo para mostrar la lista de métodos de pago y los botones express.

**Samsung Pay**

* FIXED **Cerrar la hoja de Samsung Pay informa una cancelación**\
  Cerrar la hoja de pago de Samsung Pay ahora informa una cancelación del usuario en lugar de mostrar una pantalla de "Transacción fallida", y ya no deja atascado el estado de carga del comercio.

**Card Payments**

* FIXED **Se corrigieron las notificaciones de cuotas de las tarjetas inscritas**\
  El callback onInstallmentSelected ahora se dispara solo desde la tarjeta inscrita que seleccionó el cliente: notifica la cuota predeterminada en la primera selección, los cambios hechos mientras la tarjeta está activa y la última selección al regresar a la tarjeta. Las tarjetas no seleccionadas ya no emiten notificaciones duplicadas al cambiar de método de pago.

## v1.10.0

*29 de julio de 2026*

**Samsung Pay**

* ADDED **Compatibilidad con Samsung Pay en el SDK Web**\
  Agrega Samsung Pay como botón de billetera externa. El SDK carga el Web Checkout SDK de Samsung, lee la configuración sdk\_provider que devuelve el backend, abre la hoja de pago de Samsung y reenvía la credencial de pago tokenizada a Yuno para su autorización.

**Card Payments**

* CHANGED **Visualización simplificada de la tarjeta guardada**\
  Se eliminó la vista previa con la imagen de la tarjeta del flujo de tarjeta guardada (tokenizada) y se reemplazó por una vista previa compacta que muestra la marca de la tarjeta, los últimos cuatro dígitos, el nombre del titular y la fecha de vencimiento.

* BREAKING **Mejor renderizado del formulario de tarjeta inscrita**\
  El formulario de tarjeta inscrita ya no reserva espacio vacío cuando no tiene campos que mostrar, y ahora muestra el campo del nombre del titular de la tarjeta cuando la configuración del método de pago lo requiere.

* FIXED **Callback onInstallmentSelected para tarjetas inscritas**\
  Se agregó compatibilidad con el callback onInstallmentSelected en las tarjetas inscritas.

**Google Pay**

* FIXED **Se corrigieron los colores del botón de Google Pay**\
  Ahora el botón de Google Pay siempre respeta un buttonColor configurado explícitamente (white o black), incluso cuando la página se ejecuta en modo oscuro. La configuración predeterminada sigue adaptándose automáticamente al esquema de colores de la página.

**Core SDK**

* CHANGED **Mejor diseño de los botones express**\
  Ahora el checkout completo muestra hasta tres botones de pago express uno al lado del otro, con estilos predeterminados unificados. Los botones express que no caben en la fila se muestran dentro de la lista de métodos de pago y muestran su botón nativo cuando se seleccionan.

* ADDED **Compatibilidad con la inicialización en la región de la UE**\
  Ahora el SDK Web puede inicializarse contra la región de la UE, y enruta todas las llamadas de red del SDK a la API de checkout de la UE. Las integraciones existentes sin región configurada siguen usando el endpoint actual sin cambios.

* ADDED **Eventos de analítica del ciclo de vida del checkout**\
  Agrega `checkoutSdk_started` y `payment_resolved`, y enriquece el `checkoutSdk_completed` existente con atributos de UX (clics, toques, pulsaciones de teclas, desplazamiento), de modo que un checkout pueda medirse de principio a fin: cuándo empieza, cómo se resolvió el pago y, según la presencia de `checkoutSdk_completed`, si se completó o se abandonó. Ambos eventos nuevos se envían en el momento de la emisión para que no se pierdan por el debounce del lote.

**PayPal**

* ADDED **Compatibilidad con la inscripción de acuerdos de facturación de PayPal**\
  Ahora el SDK permite inscribir clientes con acuerdos de facturación de PayPal (PAYPAL\_BA\_ENROLLMENT) y envía el ID de atribución de socio de PayPal al cargar el SDK de PayPal.

**Checkout**

* ADDED **Callback de métodos de pago solo express**\
  Se agregó un callback opcional `onlyExpressPaymentMethods` a la configuración del checkout completo, que informa `true` cuando todos los métodos de pago disponibles se muestran como botón express (Apple Pay, Google Pay, PayPal, inscripción de PayPal, PayPal Braintree, Revolut Pay) y `false` en caso contrario. Cuando solo hay métodos express disponibles, el divisor "O paga con" ya no se muestra debajo de los botones express.

* BREAKING **Los pies de Click to Pay usan el pie de modal compartido**\
  Las pantallas del formulario de tarjeta, de tarjeta inscrita y de selección de cuotas de Click to Pay ahora muestran el pie de modal compartido en lugar de una copia específica de Click to Pay, en línea con el rediseño del botón de ancho completo y de la etiqueta "Powered by Yuno" centrada. Se conservan los ganchos CSS heredados (`sdk-payments-c2p-button-bottom__modal-bottom`, `__button-continue`, `__button-back`) y las clases compartidas se agregan junto a ellos; las clases contenedoras internas `sdk-payments-c2p-button-bottom__buttons-content` y `__button-wrapper` ya no existen en el DOM. La insignia del pie de Click to Pay ahora enlaza la URL de la política de privacidad específica de cada país en lugar de usar siempre la global de respaldo.

* BREAKING **Botón de acción de ancho completo en los pies de modal**\
  El botón de acción del pie de modal compartido ahora ocupa todo el ancho en cualquier viewport, con la etiqueta de privacidad "Powered by Yuno" centrada encima. Lite mantiene la etiqueta debajo del botón. Los formularios embebidos que se muestran con `renderMode: element` no cambian.

## v1.9.53

*21 de octubre de 2026*

**Core SDK**

* CHANGED **La disponibilidad de Apple Pay siempre usa la verificación de capacidades**\
  El botón de Apple Pay ya no lee la configuración `apple_pay_capabilities_enabled`: cuando la API `applePayCapabilities` de Apple está disponible y se conoce el identificador del comercio, esta decide si se muestra el botón, tal como ya ocurría con la configuración activada para todos los comercios. Sin la API, o cuando la llamada falla, el SDK sigue recurriendo a `canMakePayments()`. Sin cambios visibles.

## v1.9.51

*12 de octubre de 2026*

**Core SDK**

* FIXED **La disponibilidad de Apple Pay recurre a la verificación heredada cuando Safari no tiene applePayCapabilities**\
  Cuando la configuración `apple_pay_capabilities_enabled` está activada, ahora el SDK llama a `ApplePaySession.applePayCapabilities()` solo si el navegador la expone. En las versiones de Safari que no la tienen (anteriores a iOS 18 y macOS Sequoia), o cuando la llamada falla, el SDK usa la verificación heredada `canMakePayments()` en lugar de ocultar el botón de Apple Pay. Cuando la API informa `paymentCredentialsUnavailable` (no hay ninguna tarjeta en la billetera), el botón permanece oculto.

## v1.9.50

*8 de octubre de 2026*

**Core SDK**

* ADDED **Los eventos del SDK informan cuánto debe desplazarse la página para llegar al botón de pago del formulario abierto**\
  `checkout.completed` y `checkout.abandoned` ahora incluyen `scroll_needed_px`, cuánto hay que desplazar la página desde su parte superior para que el botón de pago del formulario del método de pago abierto quede en pantalla, y `viewport_height_px` como contexto. El valor es una medición de diseño: es el mismo sin importar hasta dónde haya desplazado el comprador, y un formulario más corto lo reduce. Se lee cuando se abre un formulario (al seleccionarlo en la lista desplegada, cuando el formulario se muestra en los modos de renderizado modal y element), de nuevo cada vez que el área del SDK o el modal del SDK cambian de tamaño mientras carga el formulario, cuando el comprador confirma el pago y cuando se envía el evento; una lectura que encuentra el botón de pago siempre prevalece y una que no lo encuentra nunca la reemplaza, por lo que el cargador del pago no la sobrescribe. Apunta al botón de pago visible del SDK: el botón de pago del pie del modal o el botón de envío del formulario, contando el desplazamiento restante dentro de un modal con scroll o de una superposición modal. Cuando el comercio muestra su propio botón, el borde inferior de lo que dibujó el SDK lo reemplaza. No se envía nada cuando no se abrió ningún formulario. El `scroll_distance_px` existente no cambia.

## v1.9.47

*30 de septiembre de 2026*

**Google Pay**

* FIXED **Se corrigió CALLBACK\_TIMED\_OUT de Google Pay en Chrome para Android**\
  Google Pay en Chrome para Android podía mostrar CALLBACK\_TIMED\_OUT y bloquear el pago. El SDK ya no solicita el callback de autorización de pago de Google; ahora onLoading para el token de un solo uso se dispara cuando la hoja devuelve los datos del pago. onLoading también informa isLoading en false cuando falla el token o la solicitud de pago después de que se cierra la hoja, por lo que ya no queda en true.

## v1.9.46

*24 de septiembre de 2026*

**Core SDK**

* FIXED **`three_ds.completed` ahora informa el resultado de 3DS en lugar del resultado del pago**\
  Cuando la autenticación 3DS tiene éxito y luego el adquirente rechaza el pago, `three_ds.completed` informa `result: authenticated` y el rechazo queda en `payment.resolved`. El resultado se lee de la última transacción del pago que el SDK ya recibe (su proveedor y código de respuesta). Cuando esa transacción no está disponible, por ejemplo cuando el estado final llega por el websocket, el resultado sigue el resultado del pago como antes. Límite conocido: los proveedores que autentican y autorizan en una sola transacción y no exponen un código de respuesta de 3DS, hoy Adyen (unas 200 sesiones 3DS de Adyen por semana), informan sus rechazos de 3DS como `authenticated` hasta que.

## v1.9.45

*19 de septiembre de 2026*

**Lite Web SDK**

* FIXED **Se corrigieron los datos bancarios en la inscripción SEPA**\
  La inscripción solo enviaba el número de cuenta, el nombre del beneficiario y el número de ruta cuando los tres estaban completos, por lo que los métodos que no piden número de ruta (SEPA Direct Debit) perdían los otros dos. Ahora cada campo se envía siempre que tenga un valor.

## v1.9.44

*18 de septiembre de 2026*

**Payment Methods**

* FIXED **Click to Pay muestra el separador "or" en el idioma del comprador**\
  El separador entre "access my linked cards" y "enter the card manually" en las pantallas de correo y de código de un solo uso de Click to Pay decía "Ó" en portugués y español, y se quedaba en inglés en otros catorce idiomas. Ahora dice "OU" en portugués, "O" en español, y está traducido en árabe, alemán, francés, italiano, japonés, coreano, neerlandés, polaco, ruso, sueco, turco, vietnamita y chino.

## v1.9.42

*14 de septiembre de 2026*

**Card Payments**

* FIXED **Respetar la tecla Siguiente del teclado en todos los campos del formulario de tarjeta**\
  Al presionar Siguiente en el teclado móvil, el foco ahora avanza por todos los campos del formulario de tarjeta y, después del último, pasa al nombre del titular, para todas las cuentas, incluidas las que tienen desactivado el avance automático de campos.

## v1.9.36

*21 de agosto de 2026*

**Payment Actions**

* FIXED **Recopilación de datos del dispositivo para 3DS de Worldpay**\
  Los pagos con tarjeta enrutados por el 3DS propio de Worldpay ahora ejecutan el paso de recopilación de datos del dispositivo y reportan la huella digital resultante al proveedor, de modo que el desafío de autenticación se comporte correctamente en lugar de degradarse en silencio. La misma corrección se aplica al flujo headless, y otros proveedores de 3DS ahora también reenvían la sesión de dispositivo que recopilan.

## v1.9.34

*17 de agosto de 2026*

**Card Payments**

* FIXED **Validación del número de tarjeta cuando la consulta de BIN es desconocida o falla**\
  Ahora el formulario de tarjeta valida el número de tarjeta de forma predeterminada cuando falla la consulta de BIN o devuelve un IIN desconocido, en lugar de omitir la validación en silencio.

## v1.9.33

*14 de agosto de 2026*

**Card Payments**

* FIXED **RTL en hebreo y persa en el formulario de tarjeta**\
  Los campos seguros del formulario de tarjeta ahora se renderizan de derecha a izquierda para hebreo y persa, en línea con la dirección del shell del checkout.

## v1.9.32

*13 de agosto de 2026*

**Card Payments**

* FIXED **Se corrigieron los bordes de campo recortados y la animación de foco en el formulario de tarjeta**\
  Los bordes de los campos del formulario de tarjeta ya no se muestran cortados en algunos dispositivos móviles, y la animación de foco ya no se recorta.

## v1.9.30

*13 de agosto de 2026*

**Google Pay**

* FIXED **Se corrigió el estado hover atascado del botón de Google Pay**\
  Se corrigió que el botón de Google Pay se quedara en su estado hover gris en dispositivos táctiles después de abrir y cerrar la hoja de pago.

## v1.9.29

*12 de agosto de 2026*

**Google Pay**

* FIXED **Mejor manejo del doble toque en Google Pay**\
  Se corrigió un problema por el cual tocar rápidamente dos veces el botón de Google Pay provocaba una recarga de la página mientras la hoja de pago estaba abierta, lo que impedía que la hoja completara el pago.

## v1.9.28

*10 de agosto de 2026*

**Card Payments**

* FIXED **Se corrigieron problemas con la selección de cuotas en el formulario de tarjeta**\
  La cuota seleccionada se conserva mientras se escribe en el formulario de tarjeta, y onInstallmentSelected vuelve a notificar la última selección al regresar al método de pago con tarjeta.

## v1.9.27

*9 de agosto de 2026*

* CHANGED **Resolución del host de 3DS según el entorno**\
  Resuelve el host de sdk-3ds (challenge.html, session-id.html y el origen de los eventos de 3DS) a partir del entorno de ejecución del SDK, codificado en la clave pública de API, en lugar de fijarlo en el bundle durante la compilación, y entrega la mitad del despliegue para que realmente surta efecto. Las tres URL de sdk-3ds ahora usan la forma con plantilla `_ENVIRONMENT_` en el archivo de entorno compartido, por lo que `resolveEnvHost` las resuelve en tiempo de ejecución. Hasta ahora, cada bundle publicado llevaba un host concreto fijado durante la compilación: un comercio de sandbox que ejecutaba el bundle de prod seguía llegando a `sdk-3ds.prod.y.uno` con un token de sesión firmado para sandbox y recibía un 403 Forbidden sin más, en lugar del desafío 3DS, lo que dejaba el pago atascado en `PENDING / WAITING_ADDITIONAL_STEP`. Cuando la clave pública de API no incluye un prefijo de entorno reconocible, el host recurre al entorno para el que se compiló el bundle, de modo que el marcador nunca llegue a una solicitud.

## v1.9.25

*6 de agosto de 2026*

**Payment Actions**

* FIXED **Se corrigió showPaymentStatus en los fallos de pago**\
  Cuando showPaymentStatus está en false, el SDK ya no muestra a pantalla completa el mensaje "Transacción fallida" en fallos tempranos del pago (pago no encontrado o aún no procesado); en su lugar, el error se entrega mediante el callback onError.

## v1.9.24

*3 de agosto de 2026*

* CHANGED **Inscripción de PayPal**\
  Evita el doble manejo de errores cuando la consulta del pago falla después de la aprobación: ahora la pantalla de error o el callback de error del comercio se dispara exactamente una vez, respetando `showPaymentStatus`.

## v1.9.23

*31 de julio de 2026*

* CHANGED **Estado del pago en la inscripción de PayPal**\
  Resuelve el estado del pago que se informa al comercio a partir del servidor, en lugar de asumir SUCCEEDED cuando PayPal aprueba.

## v1.9.19

*29 de julio de 2026*

**Card Payments**

* FIXED **Callback onInstallmentSelected para tarjetas inscritas**\
  Se agregó compatibilidad con el callback onInstallmentSelected en las tarjetas inscritas.

## v1.9.18

*28 de julio de 2026*

**Checkout**

* ADDED **Callback de métodos de pago solo express**\
  Se agregó un callback opcional `onlyExpressPaymentMethods` a la configuración del checkout completo, que informa `true` cuando todos los métodos de pago disponibles se muestran como botón express (Apple Pay, Google Pay, PayPal, inscripción de PayPal, PayPal Braintree, Revolut Pay) y `false` en caso contrario. Cuando solo hay métodos express disponibles, el divisor "O paga con" ya no se muestra debajo de los botones express.

## v1.9.17

*20 de julio de 2026*

**Core SDK**

* CHANGED **El radio del método de pago pasa al borde inicial (compatible con RTL)**\
  BREAKING (valor visual predeterminado): ahora el radio de selección del método de pago se muestra en el borde inicial (izquierdo) de cada fila, y se refleja automáticamente a la derecha en los idiomas RTL (árabe, hebreo, persa, urdu). Los comercios con CSS personalizado dirigido al antiguo radio alineado a la derecha pueden necesitar ajustar sus selectores. La posición final sigue disponible mediante la prop RadioButton showRadioLeft= en sdk-web-core.

* ADDED **Seis nuevos idiomas del checkout**\
  Agrega la localización en griego, hebreo, rumano, eslovaco, serbio (latino) y ucraniano al checkout del SDK Web.

**Fraud & Risk**

* ADDED **Recopilación de datos del dispositivo de Braintree**

## v1.9.16

*14 de julio de 2026*

**Card Payments**

* ADDED **Se corrigieron las cuotas de las tarjetas duales en el modo solo crédito**\
  Las opciones de cuotas ahora se cargan correctamente para las tarjetas duales de Brasil cuando credit\_card\_only\_processing está activado, lo que asegura que los pagos se tokenicen como crédito con la selección de cuotas adecuada.

**APM**

* FIXED **Compatibilidad con el formulario compacto en los campos de transferencia bancaria**\
  Se agregó compatibilidad con el formulario compacto en los campos de transferencia bancaria.

## v1.9.15

*10 de julio de 2026*

**Fraud & Risk**

* FIXED **Reemplazo del ID de sesión de la huella digital de CyberSource**\
  La huella digital de CyberSource/Cielo CyberSource ahora respeta el reemplazo de session\_id por proveedor (deviceFingerprints), lo que permite prefijos de MID específicos de cada comercio en el ID de sesión de ThreatMetrix.

**Card Payments**

* FIXED **Etiquetas coherentes en los campos de tarjeta**\
  Los campos del número de tarjeta, la fecha de vencimiento y el CVV ahora obtienen sus etiquetas de la misma fuente de textos de la interfaz en todas las variantes del formulario de tarjeta, por lo que el checkout completo y el SDK Lite muestran textos idénticos para la misma configuración de sesión de checkout.

## v1.9.14

*9 de julio de 2026*

**Core SDK**

* CHANGED **Etiquetas y campos obligatorios del checkout dirigidos por el backend**\
  Ahora el formulario del checkout se muestra a partir de la configuración que se devuelve con cada método de pago. Las etiquetas de los campos, los marcadores de posición, los mensajes de validación, las opciones de selección y qué campos se muestran los define el backend, por lo que el formulario siempre refleja exactamente lo que requiere cada método de pago y cada proveedor, mostrado en el idioma del comprador. Cuando no se proporciona esta configuración, el SDK recurre a su texto localizado integrado, por lo que las integraciones existentes siguen funcionando sin necesidad de cambiar el código.

**Card**

* FIXED **Formato coherente del menú desplegable de cuotas**\
  Ahora el menú desplegable de cuotas muestra todas las opciones con la misma plantilla (`Nx of {value} - Total {total}`), sin importar si la opción incluye costos financieros, lo que corrige los diseños mezclados cuando un plan combina opciones con y sin `financial_costs`.

**APM**

* ADDED **Campos de cuenta para débito directo ACH**\
  Se agregaron dos campos nuevos al formulario de transferencia bancaria: Tipo de cuenta (Corriente/Ahorros) y Tipo de titular de la cuenta (Individual/Empresa).

**PayPal**

* FIXED **Mejor carga del botón de PayPal Braintree**\
  El marcador de posición de carga ahora coincide con el estilo del botón configurado mediante `externalButtons.paypalBraintree.style` (ancho, alto y radio del borde), lo que elimina la diferencia visual mientras el botón carga

## v1.9.13

*7 de julio de 2026*

**Autocompletado de direcciones**

* ADDED **Autocompletado de direcciones con Google Places + ViaCEP en Brasil**\
  Una única bandera de funcionalidad `address_autofill_enabled` habilita una nueva experiencia de autocompletado de direcciones. En los países que no son Brasil, el usuario obtiene un combobox de Google Places con hasta 5 sugerencias en vivo, control de cadencia, respaldo silencioso a la entrada manual y eventos de analítica. En Brasil, el campo se reduce al CEP solamente, y ViaCEP se dispara automáticamente cuando el código postal coincide con la expresión regular `/^\d{5}-?\d{3}$/` (con blur como respaldo); el resto de los campos se despliegan después de que el intento tenga éxito o falle. El país del formulario determina la decisión y se reinicia correctamente al cambiar de país. 6 claves i18n nuevas traducidas en 26 idiomas.

## v1.9.12

*6 de julio de 2026*

**PayPal**

* CHANGED **Mejor flujo de checkout de PayPal Braintree**\
  Mejora el método de pago del botón externo PAYPAL\_BRAINTREE, que ahora se basa en braintree-web y en PayPal Web SDK v6

## v1.9.11

*2 de julio de 2026*

**Payment Actions**

* ADDED **Reintento de pago en el checkout Lite**\
  Ahora el reintento de pago funciona en el flujo del checkout Lite (`mountCheckoutLite`). Un pago con tarjeta rechazado o con error muestra errores en línea en los campos y se reintenta sin reiniciar el checkout, controlado por `settings.card.enable_payment_retry`.

## v1.9.10

*30 de junio de 2026*

**Checkout**

* CHANGED **Formato de moneda localizado según el idioma del comercio**\
  Ahora los montos siguen el YunoLanguage configurado por el comercio más el countryCode de cada checkout (mediante Intl.NumberFormat) en lugar de derivarse de la moneda, lo que corrige los separadores decimales y de miles, la posición del símbolo y el espaciado en los checkouts que no están en inglés. La moneda sigue determinando el símbolo frente al código ISO y los decimales.

**Métodos de pago alternativos**

* CHANGED **Mostrar el campo de OTP de BLIK en todos los modos de visualización del checkout**\
  Ahora BLIK solicita su código de un solo uso en todos los modos de visualización del checkout (desplegado, modal (SDK Lite) y render) en lugar de solo en el flujo desplegado. El código ingresado se envía en la solicitud del token de un solo uso para que el pago pueda completarse desde cualquier modo de integración.

**Core SDK**

* CHANGED **Selección automática de un único método de pago**\
  Cuando no hay ningún método de pago inscrito y solo hay un método de pago que no es un botón, ahora se preselecciona automáticamente.

**Payment Actions**

* FIXED **Notificación de la acción de estado**\
  Ahora el SDK notifica al callback onActionExecuted con una acción CHECK\_STATUS cuando se muestra la pantalla de estado del pago, para que los comercios puedan cerrar de forma confiable sus propios indicadores de carga.

## v1.9.9

*24 de junio de 2026*

**Core SDK**

* SECURITY **Pasa un JWT por sesión a challenge.html y agrega un handshake con postMessage con verificación de nonce y de origen para el flujo de restricción de frames de 3DS.**

## v1.9.8

*23 de junio de 2026*

* CHANGED **CORREGIDO: Permite descargar la imagen del QR en los códigos QR generados en el cliente (`GENERATE_QR`, por ejemplo QRIS/Xendit). Ahora el botón "Descargar imagen QR" se muestra en estos métodos de pago y guarda el código en pantalla como un PNG generado en el cliente con `qrcode`. Antes el botón solo aparecía para los QR de imagen listos para usar (URL/BASE64), por lo que QRIS nunca lo mostraba aunque el backend enviara la etiqueta `download_qr`.**

**Card Payments**

* ADDED **Validación de la longitud del número de tarjeta por esquema**\
  Ahora la longitud del número de tarjeta se valida por esquema de tarjeta con reglas dirigidas por el backend combinadas con la verificación de Luhn, lo que reduce los rechazos falsos de tarjetas válidas. Controlado por una bandera de funcionalidad.

* FIXED **CORREGIDO: Enruta los recursos del iframe de sdk-web-card (páginas de campos seguros, formulario de tarjeta, mediador) a través del host de recursos en el modo de marca blanca. Se resolvían contra `apiUrl`, por lo que, cuando un comercio configuraba un `assetUrl` distinto con una subruta de proxy (por ejemplo `/hosted-payment-methods/orchestrator`), la subruta se perdía y los campos seguros se cargaban desde la ruta equivocada en los flujos de inscripción y de tarjeta inscrita.**

## v1.9.7

*17 de junio de 2026*

**Payment Actions**

* CHANGED **Informar la acción de pago ejecutada**\
  Ahora `continuePayment()` te indica qué acción de pago se está ejecutando: se resuelve con la acción ejecutada y acepta un nuevo callback opcional `onActionExecuted` que se dispara con cada acción. Úsalo para mantener tu indicador de carga en pantalla hasta que una redirección de 3DS navegue, y evitar el parpadeo del formulario de tarjeta antes del desafío.

**Card Payments**

* FIXED **El título del formulario de tarjeta ya no parpadea durante la carga**\
  En el formulario de tarjeta compacto embebido con `elementSelector`, el título "Información de la tarjeta" ahora aparece junto con los campos de la tarjeta cuando terminan de cargar, en lugar de mostrarse sobre un formulario vacío.

**Core SDK**

* FIXED **Preselección coherente del método de pago**\
  Ahora la preselección del método de pago es coherente entre el estado del checkout y la interfaz en las listas expandida y contraída: el método seleccionado siempre se refleja en la lista, y se preselecciona un método cuando el backend no especifica una preferencia.

## v1.9.5

*15 de junio de 2026*

**Secure Fields**

* FIXED **Se corrigió el error de consola en los campos de la tarjeta**\
  El formulario de tarjeta ya no lanza un error no capturado al ingresar una tarjeta cuya red no requiere un PIN de tarjeta.

## v1.9.4

*15 de junio de 2026*

**Core SDK**

* CHANGED **Antepone la ruta base de marca blanca configurada a las URL de recursos, iframes y WebSocket con host reemplazado, para que el SDK permanezca bajo un proxy montado en una subruta (por ejemplo `.../orchestrator`) en lugar de caer al origen simple. El origen de postMessage de 3DS queda excluido.**

**Revolut Pay**

* ADDED **Compatibilidad con el retorno móvil de Revolut Pay**\
  Ahora Revolut Pay devuelve a los compradores al checkout de forma confiable en móvil después de la redirección o del traspaso entre aplicaciones.

## v1.9.2

*11 de junio de 2026*

**Core SDK**

* CHANGED **Validación más estricta de teléfono y documento**\
  Los campos de teléfono y número de documento ahora bloquean los caracteres inválidos mientras se escribe, y los números de documento pasan por una validación de dígito verificador, habilitada gradualmente mediante el despliegue de la validación en tiempo real.

**Payment Actions**

* FIXED **Evento de checkout completado para todos los métodos**\
  Ahora el evento checkoutSdk\_completed se emite para todos los métodos de pago que se completan a través del enrutador compartido de acciones de pago (tarjeta, Google Pay, APM), igual que el comportamiento existente de Apple Pay y PayPal. Se dispara una sola vez por checkout.

**Revolut Pay**

* ADDED **Compatibilidad con Revolut Pay**\
  Agrega Revolut Pay como botón de pago externo. Admite los flujos de checkout seamless y los dirigidos por el comercio, con un botón configurable (variante, tamaño, radio, acción e idioma).

**Card Payments**

* FIXED **Se corrigieron los estilos de la variante compacta del formulario de tarjeta**\
  Se corrigió un problema en el SDK 1.9 por el cual la variante de entrada compacta se mostraba de forma incorrecta en el formulario de tarjeta y en los campos de dirección: no se aplicaban el radio de borde agrupado, los colores del borde en foco y en error, ni los mensajes de error en línea ocultos.

## v1.9.1

*3 de junio de 2026*

**Checkout**

* FIXED **Cuando solo hay un método de pago regular disponible, ahora se preselecciona automáticamente y su botón de radio aparece marcado al renderizar, sin importar si el backend lo marca como preferido.**

* FIXED **En el modo de marca blanca (cuando `apiUrl` o `assetUrl` está configurado en `initialize()`), el texto de privacidad de datos y de términos y condiciones se oculta, igual que el comportamiento de la insignia "Secure by Yuno".**

**Core SDK**

* FIXED **Los códigos QR de los métodos de pago basados en QR (como Nequi) ahora se muestran con espacio en blanco adicional alrededor del patrón, lo que mejora la fiabilidad del escaneo en teléfonos que recortan automáticamente la vista de la cámara.**

* FIXED **Ahora los recursos estáticos alojados por Yuno (como los logotipos de marcas) pueden servirse a través del proxy. Solo se reescriben los hosts de Yuno, y las URL de recursos externos quedan intactas.**

## v1.9.0

*26 de mayo de 2026*

**Marca blanca**

* BREAKING **Cambio del prefijo de los nombres de clase e IDs en marca blanca**\
  El prefijo `Yuno` de los nombres de clase e IDs cambió a `sdk-payments`. Por ejemplo, `yuno-checkout` pasa a ser `sdk-payments-checkout`.

* ADDED **API pública neutral para marca blanca**\
  Los nombres de clases CSS, IDs del DOM y nombres de eventos y callbacks de cara al público se renombraron con identificadores neutrales, aptos para marca blanca. El `window.Yuno` existente, el evento `yuno-sdk-ready` y los alias de callbacks `yuno*` siguen funcionando, por lo que las integraciones existentes de los comercios no necesitan cambios. `window.Yuno` queda obsoleto en favor de `window.SdkPayments`.

* ADDED **URL personalizadas de API y de recursos**\
  Se agregaron los reemplazos de inicialización `options.apiUrl` y `options.assetUrl` para que el SDK pueda apuntar a backends alojados por socios, endpoints de 3DS, iframes de campos seguros y recursos del formulario de tarjeta en lugar de las URL predeterminadas de Yuno. El reemplazo también se reenvía a la capa de monitoreo, al mediador y a los iframes del formulario de tarjeta.

* ADDED **Ocultar la insignia de pago seguro en alojamiento personalizado**\
  Cuando se configuran los reemplazos `apiUrl` o `assetUrl`, la insignia `Secure Payment with Yuno` se oculta automáticamente tanto en el checkout estándar como en el flujo de Click to Pay.

**Core SDK**

* FIXED **Resolución de recursos más resistente**\
  Protege la ruta pública de webpack cuando se ejecuta bajo Vite, omite los sufijos `/v<x.y>` duplicados cuando la URL del recurso ya incluye uno, y usa directamente el `apiUrl` configurado como URL base del cliente de API para evitar la corrupción del prefijo de región.

## v1.8.20

*13 de octubre de 2026*

**Core SDK**

* CHANGED **La disponibilidad de Apple Pay siempre usa la verificación de capacidades**\
  El botón de Apple Pay ya no lee la configuración `apple_pay_capabilities_enabled`: cuando la API `applePayCapabilities` de Apple está disponible y se conoce el identificador del comercio, esta decide si se muestra el botón, tal como ya ocurría con la configuración activada para todos los comercios. Sin la API, o cuando la llamada falla, el SDK sigue recurriendo a `canMakePayments()`. Sin cambios visibles.

## v1.8.19

*12 de octubre de 2026*

**Core SDK**

* FIXED **La disponibilidad de Apple Pay recurre a la verificación heredada cuando Safari no tiene applePayCapabilities**\
  Cuando la configuración `apple_pay_capabilities_enabled` está activada, ahora el SDK llama a `ApplePaySession.applePayCapabilities()` solo si el navegador la expone. En las versiones de Safari que no la tienen (anteriores a iOS 18 y macOS Sequoia), o cuando la llamada falla, el SDK usa la verificación heredada `canMakePayments()` en lugar de ocultar el botón de Apple Pay. Cuando la API informa `paymentCredentialsUnavailable` (no hay ninguna tarjeta en la billetera), el botón permanece oculto.

## v1.8.18

*5 de octubre de 2026*

**Core SDK**

* ADDED **Los eventos del SDK informan cuánto debe desplazarse la página para llegar al botón de pago del formulario abierto**\
  `checkout.completed` y `checkout.abandoned` ahora incluyen `scroll_needed_px`, cuánto hay que desplazar la página desde su parte superior para que el botón de pago del formulario del método de pago abierto quede en pantalla, y `viewport_height_px` como contexto. El valor es una medición de diseño: es el mismo sin importar hasta dónde haya desplazado el comprador, y un formulario más corto lo reduce. Se lee cuando se abre un formulario (al seleccionarlo en la lista desplegada, cuando el formulario se muestra en los modos de renderizado modal y element), de nuevo cada vez que el área del SDK o el modal del SDK cambian de tamaño mientras carga el formulario, cuando el comprador confirma el pago y cuando se envía el evento; una lectura que encuentra el botón de pago siempre prevalece y una que no lo encuentra nunca la reemplaza, por lo que el cargador del pago no la sobrescribe. Apunta al botón de pago visible del SDK: el botón de pago del pie del modal o el botón de envío del formulario, contando el desplazamiento restante dentro de un modal con scroll o de una superposición modal. Cuando el comercio muestra su propio botón, el borde inferior de lo que dibujó el SDK lo reemplaza. No se envía nada cuando no se abrió ningún formulario. El `scroll_distance_px` existente no cambia.

## v1.8.17

*24 de septiembre de 2026*

**Core SDK**

* FIXED **`three_ds.completed` ahora informa el resultado de 3DS en lugar del resultado del pago**\
  Cuando la autenticación 3DS tiene éxito y luego el adquirente rechaza el pago, `three_ds.completed` informa `result: authenticated` y el rechazo queda en `payment.resolved`. El resultado se lee de la última transacción del pago que el SDK ya recibe (su proveedor y código de respuesta). Cuando esa transacción no está disponible, por ejemplo cuando el estado final llega por el websocket, el resultado sigue el resultado del pago como antes. Límite conocido: los proveedores que autentican y autorizan en una sola transacción y no exponen un código de respuesta de 3DS, hoy Adyen (unas 200 sesiones 3DS de Adyen por semana), informan sus rechazos de 3DS como `authenticated` hasta que.

## v1.8.16

*18 de septiembre de 2026*

**Payment Methods**

* FIXED **Click to Pay muestra el separador "or" en el idioma del comprador**\
  El separador entre "access my linked cards" y "enter the card manually" en las pantallas de correo y de código de un solo uso de Click to Pay decía "Ó" en portugués y español, y se quedaba en inglés en otros catorce idiomas. Ahora dice "OU" en portugués, "O" en español, y está traducido en árabe, alemán, francés, italiano, japonés, coreano, neerlandés, polaco, ruso, sueco, turco, vietnamita y chino.

## v1.8.7

*9 de julio de 2026*

**Card**

* FIXED **Formato coherente del menú desplegable de cuotas**\
  Ahora el menú desplegable de cuotas muestra todas las opciones con la misma plantilla (`Nx of {value} - Total {total}`), sin importar si la opción incluye costos financieros, lo que corrige los diseños mezclados cuando un plan combina opciones con y sin `financial_costs`.

## v1.8.1

*22 de mayo de 2026*

**Core SDK**

* ADDED **Compatibilidad con el idioma mongol**\
  Agrega el mongol (mn) como idioma admitido para la experiencia de checkout del SDK Web.

* ADDED **Selección automática de un único método de pago**\
  Cuando el checkout se muestra con exactamente un método de pago regular (que no es express) disponible, ese método ahora se selecciona automáticamente para que el cliente vaya directo al formulario. Los botones express (Apple Pay, Google Pay, PayPal) ya no se tratan como un método preferido por el backend que interrumpe este flujo.

* FIXED **Errores detallados de generateOTT()**\
  Cuando `apiClientPayment().generateToken` (`generateOTT`) falla, el error rechazado ahora contiene el cuerpo de la respuesta del backend (con códigos de error y detalle) en lugar de solo el error genérico de axios. Los comercios que capturan esta llamada reciben información de error accionable.

**Click to Pay**

* CHANGED **Cuotas diferidas en el Golden Flow de Click to Pay**\
  Ahora los planes de cuotas del Golden Flow de Click to Pay se muestran en una pantalla dedicada después de que el cliente elige entre Click to Pay y el riel de tarjeta estándar, en lugar de consultarse automáticamente mientras se escribe el PAN. El formulario de tarjeta permanece montado debajo para que el estado de los campos seguros se conserve entre pantallas.

## v1.8.0

*14 de mayo de 2026*

**Apple Pay**

* ADDED **Recopilación de direcciones en Apple Pay**\
  Ahora la hoja de pago de Apple Pay puede recopilar direcciones de facturación y de envío cuando se configura mediante `required_fields`. El comportamiento predeterminado no cambia cuando no se configura.

* ADDED **BIN de Apple Pay disponible antes del pago**\
  Ahora el BIN del DPAN está disponible en el OTT antes del pago, lo que habilita promociones y descuentos basados en el BIN. El flujo existente del BIN de tarjeta no se ve afectado.

* CHANGED **Mejor detección de la disponibilidad de Apple Pay**\
  Ahora el botón de Apple Pay aparece con más precisión en los dispositivos compatibles, lo que reduce los casos en que el botón se muestra a usuarios que no pueden completar un pago con Apple Pay.

**Google Pay**

* ADDED **Recopilación de direcciones en Google Pay**\
  Ahora la hoja de pago de Google Pay puede recopilar la dirección de facturación, la dirección de envío y el nombre del titular de la tarjeta cuando se configura mediante `required_fields`. El nivel de detalle de la dirección se ajusta automáticamente según lo que se solicite.

* ADDED **Recopilación de campos de contacto en Google Pay**\
  Ahora la hoja de pago de Google Pay puede recopilar el correo electrónico y el número de teléfono del cliente cuando se configura mediante `contactFields`. Funciona tanto en las integraciones estándar como en las de botones externos seamless.

**Card Payments**

* CHANGED **Secciones separadas de facturación y envío**\
  Ahora el formulario de tarjeta muestra la facturación y el envío como secciones distintas, con sus propios encabezados y un campo opcional `Address line 2`. Cuando se requieren ambas direcciones, aparece una casilla `Billing address is the same as shipping`, activada de forma predeterminada.

* ADDED **Diseño compacto del formulario de tarjeta**\
  Nuevo diseño más delgado del formulario de tarjeta, con espaciado más ajustado, datos de la tarjeta agrupados y mensajes de error en línea por campo. Disponible en todas las variantes de formulario del SDK. Detrás de una bandera de funcionalidad para pruebas A/B.

* ADDED **Avance automático en el formulario de tarjeta**\
  El formulario de tarjeta avanza automáticamente el foco cuando los campos alcanzan su longitud esperada (PAN según el esquema detectado, vencimiento, CVV), lo que reduce la cantidad de toques para completar el formulario. La selección manual siempre tiene prioridad. Detrás de una bandera de funcionalidad, desactivada de forma predeterminada, para pruebas A/B.

* CHANGED **Validación en tiempo real de los campos de la tarjeta**\
  Ahora los campos del formulario de tarjeta se validan al perder el foco una vez que el usuario ha interactuado con ellos, en lugar de solo al hacer clic en Pagar. Los errores se borran de inmediato cuando el usuario corrige un campo inválido.

**Core SDK**

* ADDED **Acciones dinámicas de inscripción**\
  Ahora el flujo de inscripción admite componentes de interfaz dinámicos dirigidos por el servidor: pantallas de imagen, OTP, PIN e información, que se muestran según los campos que devuelve el servidor.

* CHANGED **Visualización más inteligente de la moneda**\
  Ahora la moneda muestra un símbolo solo para las 21 monedas con símbolos únicos a nivel global (€, £, etc.). Todas las demás muestran el código ISO de 3 letras (por ejemplo `COP 9.200.000`, `MXN 1.500,00`). USD es la única moneda que usa el símbolo `$`.

* ADDED **Ocultar la insignia de pago seguro de Yuno**\
  Ahora la insignia `Secure Payment with Yuno` puede ocultarse desde el Checkout Builder. Cuando se desactiva, la insignia se elimina por completo del DOM tanto en el checkout estándar como en el flujo de Click to Pay.

**Fraud & Risk**

* FIXED **Fiabilidad de la sesión de dispositivo de EBANX**\
  Se mejoró la fiabilidad de la propagación del ID de dispositivo en las solicitudes de pago, y se corrigieron los flujos de Payment Link en los que a veces se perdía antes de llegar a EBANX.

## v1.7.4

*26 de mayo de 2026*

**Core SDK**

* FIXED **Validación fiable del número de documento**\
  Cuando el backend especifica un `validationFunction` para un tipo de documento que el SDK no reconoce, ahora el campo recurre a la validación por expresión regular en lugar de marcar todos los valores como inválidos. Evita que se rompan los campos de documento cuando una nueva función de validación se despliega primero en el backend.

## v1.7.3

*11 de mayo de 2026*

**Fraud & Risk**

* FIXED **Mejor manejo de la sesión de dispositivo de EBANX**\
  Se mejoró la recuperación de la sesión de dispositivo de EBANX en los flujos de fraude compatibles.

## v1.7.2

*11 de mayo de 2026*

**Core SDK**

* ADDED **Compatibilidad con redirecciones POST**\
  Se agregó compatibilidad con proveedores de pago que requieren redirecciones `POST`.

* CHANGED **Mayor compatibilidad con campos obligatorios**\
  Se agregó compatibilidad con datos de pago obligatorios adicionales, como `shipping_address`, en los flujos compatibles.

**Secure Fields**

* ADDED **Mejor manejo de sesiones**\
  Mejora el comportamiento de Secure Fields en los flujos de pago basados en sesión.

**Card Payments**

* CHANGED **Mejores flujos de reintento con tarjeta**\
  Mejora el comportamiento de reintento de los pagos con tarjeta en los flujos de checkout compatibles.

## v1.7.1

*11 de mayo de 2026*

**Core SDK**

* FIXED **Actualizaciones del estado del pago más confiables**\
  Mejora el manejo del estado del pago cuando se interrumpe el seguimiento de la conexión en tiempo real.

**Payment Actions**

* FIXED **Mejor renderizado de QR, códigos de barras e imágenes**\
  Mejora el renderizado de los pasos de pago que dependen de imágenes, códigos QR o códigos de barras.

* CHANGED **Mejores flujos de OTP y PIN**\
  Se refinaron los pasos de pago con OTP y PIN para una experiencia de autenticación más fluida.

**Google Pay**

* FIXED **Mejor renderizado de botones**\
  Mejora el renderizado del botón de Google Pay para una experiencia de checkout más consistente.

## v1.7.0

*11 de mayo de 2026*

**Click to Pay**

* ADDED **Compatibilidad con el filtrado por tipo de tarjeta**\
  Se agregó compatibilidad con restricciones por tipo de tarjeta en los flujos de Click to Pay.

* ADDED **Compatibilidad con el monto de la transacción en los flujos con passkey**\
  La inicialización de Click to Pay ahora incluye los metadatos del monto de la transacción en los flujos con passkey compatibles.

## v1.6.22

*27 de mayo de 2026*

**Fraud & Risk**

* FIXED **ID de sesión de fraude de Cybersource desde el proveedor**\
  La sesión de huella digital del dispositivo de Cybersource para fraude ahora usa el `session_id` suministrado por el proveedor cuando está presente, y recurre a `checkoutSession` si el proveedor no suministra uno. Alinea el ID de sesión de la huella con lo que espera el proveedor de fraude y mejora las tasas de coincidencia de huellas.

## v1.6.21

*26 de mayo de 2026*

**Core SDK**

* FIXED **Validación fiable del número de documento**\
  Cuando el backend especifica un `validationFunction` para un tipo de documento que el SDK no reconoce, ahora el campo recurre a la validación por expresión regular en lugar de marcar todos los valores como inválidos. Evita que se rompan los campos de documento cuando una nueva función de validación se despliega primero en el backend.

## v1.6.20

*13 de mayo de 2026*

**Card Payments**

* ADDED **Banner de error superior en el formulario de tarjeta**\
  Al reintentar un pago, aparece un banner en la parte superior del formulario de tarjeta que describe por qué falló el intento anterior. El banner se desplaza a la vista y se resalta si el cliente intenta enviar de nuevo sin corregir el problema. Los errores por datos de tarjeta no válidos y los códigos de respuesta desconocidos ahora se muestran en este banner en lugar de como errores por campo.

## v1.6.19

*8 de mayo de 2026*

**Click to Pay**

* FIXED **Alineación del botón del formulario de tarjeta en escritorio**\
  Se restableció la alineación LTR correcta del botón de acción y de la insignia "Secure Payment by Yuno" en el formulario de tarjeta de Click to Pay (regresión en v1.6.x; v1.5 y v1.7 no se vieron afectadas). El diseño RTL se conserva.

## v1.6.18

*7 de mayo de 2026*

**Card Payments**

* FIXED **Validación de la longitud del número de tarjeta**\
  La tokenización de tarjetas ahora espera a que termine la consulta de BIN/IIN antes de enviar, de modo que los números de tarjeta se validan contra la longitud mínima correcta de cada esquema. Antes, un PAN corto válido según Luhn enviado antes de que terminara la consulta de BIN podía llegar al proveedor y ser rechazado; ahora los usuarios ven un error de longitud en línea.

## v1.6.17

*6 de mayo de 2026*

**Apple Pay**

* CHANGED **Motivos de cancelación más precisos**\
  Las cancelaciones de Apple Pay ahora se reportan con un motivo preciso, que distingue el descarte por parte del usuario (`CANCELLED_BY_USER`) de las fallas de validación del comercio o del proveedor (`CANCELLED_BY_PROVIDER`). Mejora la precisión del análisis de abandono y de las señales de salud de los proveedores; no se requieren cambios en la integración.

## v1.6.16

*16 de abril de 2026*

**Core SDK**

* ADDED **Cancelar el desafío 3DS al retroceder en el navegador**\
  Al presionar el botón de retroceso del navegador durante un desafío 3DS, el desafío ahora se cancela correctamente. Los comercios reciben la cancelación mediante `yunoPaymentResult` con el estado `PENDING` / `CANCELLED_BY_USER`; no se emite `yunoError` y el modal se desmonta sin dejar un estado obsoleto.

**Click to Pay**

* CHANGED **Orden de los botones de acción en móvil**\
  En las vistas móvil y tableta, los botones de acción de Click to Pay en el formulario de tarjeta se reordenaron para que la acción principal quede debajo de la secundaria, lo que mejora la jerarquía de la experiencia. El diseño en escritorio no cambia.

## v1.6.8

*15 de abril de 2026*

**Core SDK**

* ADDED **Función auxiliar unMountSdk()**\
  Se introdujo un nuevo método de nivel superior `unMountSdk()` para limpiar el SDK de forma explícita. Llámalo cuando retires el SDK de la página para evitar fugas de memoria.

> [accordion] Desmontar el SDK
>
> ```js theme={"theme":{"light":"github-dark","dark":"github-dark-dimmed"}}
> yuno.unmountSdk();
> ```

* CHANGED **Reversión del flujo de cancelación**\
  Se unificaron los eventos del flujo de cancelación. El SDK ahora reporta de forma explícita `CANCELED_BY_USER` en el callback `yunoPaymentResult` en todos los escenarios de cancelación.

* CHANGED **Reversión de eventos heredados**\
  Los eventos heredados relacionados con la cancelación se consolidaron en el flujo de resultado estándar. No se requieren nuevos cambios en la API.

* FIXED **Listener del token de Forter**\
  Se agregó un listener para el evento `ftr:tokenReady` para asegurar la captura confiable del token de sesión de Forter. Antes, el token podía perderse en cargas de página lentas.

**Apple Pay**

* ADDED **Compatibilidad con metadatos**\
  El flujo de cancelación ahora incluye un parámetro `metadata` con un booleano `paymentCreated`, que permite a los comercios saber si se creó un objeto de pago antes de la cancelación.

* ADDED **Reenvío de la información de contacto**\
  El SDK ahora recopila y reenvía automáticamente el correo electrónico, el teléfono y el nombre del cliente desde `shippingContact`. No requiere configuración.

**PayPal**

* ADDED **Flujo sin OTT**\
  Se agregó compatibilidad con un workflow `REDIRECT` que omite la creación del OTT y permite pagos con PayPal sin una sesión previa en el servidor.

> [accordion] Flujo de redirección de PayPal (sin OTT)
>
> ```js theme={"theme":{"light":"github-dark","dark":"github-dark-dimmed"}}
> yuno.startSeamlessCheckout({
>   paypal: {
>     workflow: 'REDIRECT',
>     orderId: 'YOUR_PAYPAL_ORDER_ID',
>   }
> });
> ```

* ADDED **Modal del botón de PayPal**\
  Nuevo componente `PaypalButtonModal` que renderiza el botón de PayPal dentro de una superposición modal, útil para los comercios que usan una interfaz de checkout personalizada.

## v1.6.7

*31 de marzo de 2026*

**Card Payments**

* ADDED **Campo de contraseña de tarjeta para tarjetas coreanas**\
  Nuevo campo seguro para los primeros 2 dígitos del PIN del titular de la tarjeta que exigen los emisores coreanos. Disponible en los flujos de tarjeta estándar, paso a paso y Click to Pay (nuevo e inscrito). Se habilita pasando `cardPinElementSelector` en la configuración de `startCheckout`; el campo se muestra cuando está habilitado para el comercio.

**Click to Pay**

* FIXED **Activación de passkey con varios proveedores de tarjeta**\
  Cuando hay varios proveedores de tarjeta configurados, el SDK ahora busca parámetros 3DS válidos en todos ellos y no solo en el primero. Passkey ahora se activa correctamente cuando el proveedor compatible con 3DS no aparece primero.

**Core SDK**

* ADDED **Traducciones al hindi, bengalí, malayalam y urdu**\
  Disponibles mediante `language: 'hi' | 'bn' | 'ml' | 'ur'`.

* ADDED **Cuotas del comercio mediante `onGetInstallments`**\
  Los comercios pueden suministrar sus propias opciones de cuotas mediante el callback `onGetInstallments(args)`, que recibe `{ bin, brand, cardType, issuerCode?, issuerName?, amount?, currency? }` y devuelve un arreglo de `{ installment, label, amount? }`; el SDK recurre a las cuotas de Yuno cuando el callback devuelve un resultado vacío. Un nuevo callback `onInstallmentSelected` se dispara tanto en la selección automática como en la elección del usuario en todos los flujos de tarjeta. Las cuotas suministradas por el comercio se omiten en la creación del token de un solo uso, ya que el comercio las maneja del lado del servidor.

* ADDED **`subStatus` en `yunoPaymentResult`**\
  El callback ahora recibe `subStatus` como segundo argumento: `yunoPaymentResult(status, subStatus?)`, lo que da información más detallada del resultado (en especial en los flujos de cancelación).

* CHANGED **Reducción del tamaño del paquete (-16%)**\
  Se configuró `env.targets` de SWC para eliminar los polyfills de ES5 en navegadores modernos.

**PayPal**

* FIXED **Idioma de PayPal**\
  El idioma del SDK ahora se pasa como `locale` a la llamada `loadScript` de PayPal para que la interfaz de PayPal coincida con el idioma configurado del checkout.

## v1.6.6

*26 de marzo de 2026*

**Apple Pay**

* ADDED **Personalización de `externalButtons`**\
  Nueva configuración en `externalButtons` para personalizar el botón de cada billetera (Apple Pay, Google Pay, PayPal).

**Core SDK**

* FIXED **Condición de carrera de WebSocket en los flujos de redirección**\
  Se resolvió una condición de carrera que podía hacer perder actualizaciones de estado.

* FIXED **Manejo de errores de WebSocket**\
  Se agregó manejo de errores en la inicialización de WebSocket para evitar fallas no controladas en la consulta del estado.

## v1.6.5

*20 de marzo de 2026*

**Apple Pay**

* CHANGED **Botón de Apple Pay unificado**\
  Se eliminó la implementación heredada de Apple Pay; el SDK ahora usa un único botón de Apple Pay de forma consistente en el checkout estándar y en las integraciones de `mountExternalButtons`, guiado por el flujo de pago del SDK.

* CHANGED **Renderizado más rápido del botón de Apple Pay**\
  La carga del SDK de Apple Pay, la consulta del monto y la obtención de la configuración ahora se ejecutan en paralelo, y se muestra un marcador de posición con estilo hasta que el botón real esté listo.

* CHANGED **Recopilación anticipada de señales de fraude**\
  Las señales de fraude se recopilan durante la inicialización del botón de Apple Pay para ampliar la cobertura en los flujos de billetera.

**Google Pay**

* CHANGED **Marcador de posición del botón de Google Pay**\
  Se muestra un marcador de posición con estilo mientras carga el SDK de Google Pay, en reemplazo del esqueleto anterior.

**Inscripción**

* CHANGED **Texto del botón de inscripción de APM**\
  El botón de confirmación de inscripción de los APM ahora dice "Continuar" en los flujos Full, Lite, Seamless y Render Mode.

**Card Payments**

* ADDED **Error en línea de selección del método de pago (escritorio)**\
  Al hacer clic en "Pagar" sin seleccionar un método de pago, ahora se muestra un mensaje de error en línea debajo de la lista de métodos de pago en escritorio. En móvil se sigue usando el toast existente.

**Payment Actions**

* ADDED **Banner de advertencia controlado por el backend**\
  Las instrucciones de pago flexibles ahora pueden mostrar un banner de advertencia opcional devuelto por el backend, lo que permite avisos específicos del proveedor, como el aviso legal de Punto Pago.

## v1.6.4

*19 de marzo de 2026*

**Fraud & Risk**

* FIXED **Integración con Riskified**\
  El script de Riskified ahora se carga con los identificadores correctos de tienda y sesión, lo que restablece la recopilación confiable de señales de fraude cuando el dominio de la tienda está configurado en el proveedor de fraude.

## v1.6.3

*18 de marzo de 2026*

**Core SDK**

* CHANGED **Flujo unificado de cancelación por el usuario**\
  Las cancelaciones de billetera, APM, Click to Pay, modal 3DS y checkout lite ahora emiten `yunoPaymentResult` con el estado `PENDING` y el subestado `CANCELLED_BY_USER`, en reemplazo del evento anterior `ERROR CANCELED_BY_USER`. Las integraciones que se ramificaban según el error heredado deben cambiar al subestado.

* CHANGED **Optimizaciones adicionales del tiempo de carga**\
  Los scripts de Google Pay y Apple Pay ahora se precargan, y `startCheckout`/`startSeamlessCheckout` obtienen los métodos de pago antes.

**Customer Fields**

* FIXED **Opciones de tipo de documento**\
  Se eliminó un filtro de país redundante que podía ocultar tipos de documento válidos en algunas configuraciones regionales.

## v1.6.1

*12 de marzo de 2026*

**Apple Pay**

* ADDED **Recopilación de contacto de facturación**\
  Apple Pay ahora puede capturar el nombre de facturación y la dirección postal del titular de la tarjeta desde la hoja de Apple Pay cuando se habilita mediante la configuración del comercio. El nombre del titular se reenvía en la carga útil del pago al completarse.

* ADDED **Compatibilidad con prueba gratuita en pagos recurrentes**\
  Apple Pay ahora admite la facturación recurrente con períodos de prueba, configurable mediante la configuración del comercio (Apple Pay JS v14).

**Card Payments**

* ADDED **Selector de red**\
  Lista desplegable en el pago paso a paso, la tarjeta desplegada, el modal de tarjeta, la inscripción y Click to Pay. Se controla mediante la configuración del comercio en el servidor.

**Fraud & Risk**

* ADDED **Proveedor de fraude Cielo CyberSource**\
  Cielo CyberSource se agregó como proveedor de fraude, enrutado a través de la integración existente de CyberSource.

* ADDED **Proveedor de huella digital de dispositivo EBANX**\
  Nuevo proveedor de huella digital de dispositivo con inicialización según el país. El país del cliente ahora se propaga a través del flujo de fraude.

**Core SDK**

* FIXED **Falla con sesiones que solo tienen botones externos**\
  Se corrigió una falla que ocurría cuando solo se configuraban botones externos (por ejemplo, Apple Pay) sin métodos de pago renderizados por el SDK.

* FIXED **Falla del formulario de tarjeta inscrita**\
  Evita una falla en tiempo de ejecución cuando faltan los metadatos de la tarjeta al detectar Amex en tarjetas inscritas.

* FIXED **Depuración de funciones en las cargas útiles de registro**\
  Las funciones del estado inicial suministrado por el comercio se eliminan antes de serializar el registro de depuración, lo que evita problemas de serialización en el checkout, el checkout seamless, el pago e inscripción headless y los flujos de estado.

## v1.6.0

*20 de marzo de 2026*

* ADDED **Compatibilidad con Subresource Integrity**\
  La etiqueta de script del SDK ahora admite el atributo `integrity` para una carga compatible con SRI, lo que evita la inyección de código no autorizado. El paquete npm `@yuno-payments/sdk-web` expone un método `loadScript` para la carga dinámica compatible con SRI.

> [accordion] Etiqueta de script con SRI
>
> ```html theme={"theme":{"light":"github-dark","dark":"github-dark-dimmed"}}
> <script
>   src="https://sdk-web.y.uno/v1.6/main.js"
>   integrity="sha384-..."
>   crossorigin="anonymous"
> ></script>
> ```

* ADDED **Idioma árabe y diseño RTL**\
  Se agregó compatibilidad con el idioma árabe (`ar`). La interfaz del checkout cambia automáticamente a un diseño de derecha a izquierda cuando se selecciona árabe; no requiere configuración adicional.

> [accordion] Inicializar con árabe
>
> ```js theme={"theme":{"light":"github-dark","dark":"github-dark-dimmed"}}
> const yuno = await window.Yuno.initialize(publicApiKey);
>
> await yuno.startCheckout({
>   checkoutSession,
>   elementSelector: '#root',
>   countryCode: 'AE',
>   language: 'ar',
> });
> ```

* CHANGED **Inicialización más rápida**\
  Mejora el rendimiento de inicialización de los SDK Lite y Full, y reduce el tiempo hasta la interactividad en la primera carga.

* ADDED **Códigos de error detallados**\
  Los errores de configuración ahora devuelven códigos de error más descriptivos, lo que facilita diagnosticar problemas de integración durante el desarrollo.

* FIXED **Centrado del modal 3DS**\
  Se corrigió un problema por el que el modal del desafío 3DS no se centraba en dispositivos móviles. Ahora el modal llena y centra correctamente el viewport.

## v1.5.26

*27 de mayo de 2026*

**Card Payments**

* ADDED **Variante de formulario compacto (backport a 1.5)**\
  Lleva el diseño más compacto del formulario de tarjeta, cliente y dirección de facturación de 1.6.x a la línea 1.5.x. Se activa de forma opcional mediante el feature flag `slimmerFormEnabled`; está desactivado por defecto y no cambia el comportamiento para los comercios que no lo activan.

## v1.5.25

*26 de mayo de 2026*

**Core SDK**

* FIXED **Validación fiable del número de documento**\
  Cuando el backend especifica un `validationFunction` para un tipo de documento que el SDK no reconoce, ahora el campo recurre a la validación por expresión regular en lugar de marcar todos los valores como inválidos. Evita que se rompan los campos de documento cuando una nueva función de validación se despliega primero en el backend.

## v1.5.20

*7 de abril de 2026*

**Apple Pay**

* FIXED **Flujo de cancelación**\
  Cuando el cliente aborta una sesión de Apple Pay, el error de cancelación ahora incluye un objeto `metadata` con los booleanos `paymentCreated` y `ottCreated` para que los comercios sepan hasta dónde había avanzado el flujo. Si se crea un pago después de que el usuario canceló, el SDK abandona automáticamente la sesión de checkout para evitar que los pagos queden atascados en `PENDING`. (Backport de la corrección de v1.6.8 a la línea 1.5.x.)

## v1.5.19

*2 de abril de 2026*

**Fraud & Risk**

* FIXED **Aislamiento del token de Forter**\
  Los tokens ahora se limitan por `siteId` de Forter, de modo que las sesiones de checkout concurrentes o secuenciales ya no leen un token obsoleto de un proveedor o sesión anterior.

* CHANGED **Script de baliza de Forter**\
  Se consolidó en una única URL (`https://prod.y.uno/sdk-static-bundles-ms/v1/static/js/forter/forter.js`) con un hash SRI actualizado para sandbox y producción. Los comercios con una lista de permitidos estricta de `script-src` en la CSP deben asegurarse de permitir `prod.y.uno`.

## v1.5.17

*1 de abril de 2026*

**Core SDK**

* ADDED **Opción de inicialización `sdkType`**\
  Nueva opción en `Yuno.initialize()` para identificar las integraciones (plugins, contextos embebidos) mediante el encabezado de solicitud `x-sdk-type` para la atribución posterior.

**Fraud & Risk**

* FIXED **Captura del token de Forter**\
  La captura del token ahora usa un enfoque basado en listeners para una captura de sesión confiable a lo largo del ciclo de vida de la página.

## v1.5.15

*19 de marzo de 2026*

**Payment Actions**

* ADDED **Banner de advertencia controlado por el backend**\
  Las pantallas de acción de pago flexibles (por ejemplo, Punto Pago) ahora pueden mostrar un banner controlado por el servidor (título y descripción) después de los pasos de instrucciones. Se configura del lado del servidor; no requiere cambios en el código del comercio.

## v1.5.14

*19 de marzo de 2026*

**Core SDK**

* CHANGED **Texto del botón de inscripción de APM**\
  El botón de confirmación de inscripción de los APM ahora dice "Continuar" en lugar de "Guardar".

**Fraud & Risk**

* FIXED **Parámetros de la baliza de Riskified**\
  Se agregaron los parámetros de consulta faltantes a la URL predeterminada de la baliza, lo que restablece la recopilación de señales de fraude.

## v1.5.11

*9 de marzo de 2026*

**Apple Pay**

* ADDED **Recopilación de contacto de facturación**\
  Apple Pay ahora puede recopilar el nombre de facturación y la dirección postal del titular de la tarjeta desde la hoja de Apple Pay cuando se habilita mediante la configuración del comercio. El nombre del titular se reenvía en la carga útil del pago. Los comercios no necesitan cambios en el código del SDK.

**Fraud & Risk**

* ADDED **Recopilación de sesión de dispositivo de EBANX**\
  Nuevo recolector de fraude de EBANX con montaje automático del script, reintento y manejo del desmontaje.

* ADDED **Proveedor de fraude Cielo CyberSource**\
  Se agregó Cielo CyberSource como proveedor de fraude compatible.

* CHANGED **Recopilación de fraude según el país**\
  La recopilación de señales de fraude ahora usa el país del cliente en los métodos de pago, el flujo lite, los secure fields, PayPal, Google Pay, Apple Pay y el cliente de API headless, lo que mejora el enrutamiento y la precisión del proveedor.

## v1.5.8

*24 de febrero de 2026*

**Apple Pay**

* ADDED **URL del dominio de la billetera**\
  Las transacciones de Apple Pay ahora incluyen la URL del dominio de la billetera.

**Card Payments**

* ADDED **Costo financiero en tarjetas inscritas**\
  El detalle del costo financiero se muestra en los pagos con tarjetas inscritas.

**Click to Pay**

* ADDED **Costo financiero en C2P**\
  El detalle del costo financiero se muestra en los flujos de Click to Pay.

**Google Pay**

* ADDED **Compatibilidad con gateways de terceros**\
  Google Pay ahora puede enrutarse a través de gateways de terceros (Adyen, Stripe, etc.), con el gateway y el ID de comercio suministrados mediante una nueva configuración de proveedor del SDK.

## v1.5.5

*16 de febrero de 2026*

**Google Pay**

* FIXED **Recarga con la hoja ya abierta**\
  Recarga si la hoja de Google Pay ya está abierta, lo que evita un estado bloqueado.

## v1.5.4

*16 de febrero de 2026*

**Core SDK**

* ADDED **Tipos de documento por país**\
  Nueva configuración en los ajustes generales para los tipos de documento por país (configuración del comercio en el servidor; no requiere cambios en el código del comercio).

## v1.5.0

*15 de enero de 2026*

* ADDED **Método mountExternalButtons**\
  El nuevo método `mountExternalButtons(buttons)` permite a los comercios renderizar los botones de Google Pay y Apple Pay en cualquier ubicación personalizada de su interfaz, con control total sobre la posición y el estilo de los botones.

> [accordion] Montar botones de billetera en ubicaciones personalizadas
>
> ```js theme={"theme":{"light":"github-dark","dark":"github-dark-dimmed"}}
> const yuno = await window.Yuno.initialize(publicApiKey);
>
> await yuno.startCheckout({
>   checkoutSession,
>   elementSelector: '#root',
>   countryCode: 'US',
>   language: 'en',
> });
>
> await yuno.mountExternalButtons([
>   {
>     paymentMethodType: 'APPLE_PAY',
>     elementSelector: '#apple-pay',
>   },
>   {
>     paymentMethodType: 'GOOGLE_PAY',
>     elementSelector: '#google-pay',
>   },
> ]);
> ```

* ADDED **Métodos para desmontar botones**\
  Se agregó `unmountExternalButton(paymentMethodType)` para quitar un solo botón de billetera externo y `unmountAllExternalButtons()` para quitar de una vez todos los botones de billetera montados.

> [accordion] Desmontar botones de billetera
>
> ```js theme={"theme":{"light":"github-dark","dark":"github-dark-dimmed"}}
> // Remove a single button
> yuno.unmountExternalButton('APPLE_PAY');
>
> // Remove all buttons
> yuno.unmountAllExternalButtons();
> ```

* CHANGED **Botones de billetera como botones directos**\
  Google Pay y Apple Pay ahora aparecen como botones de acción directa en lugar de elementos de una lista de botones de opción, lo que ofrece una ubicación más limpia y destacada en la interfaz del checkout.

* CHANGED **Experiencia de inscripción con PayPal**\
  La hoja de pago de PayPal ahora se abre de inmediato después de que el cliente selecciona PayPal para la inscripción o el pago, lo que elimina un paso de confirmación adicional y acelera el checkout.

**Lite Web SDK**

* BREAKING **Botones externos obligatorios en el SDK Lite**\
  Google Pay y Apple Pay en el Lite Web SDK ahora requieren un montaje explícito mediante `mountExternalButtons()`. Antes se renderizaban automáticamente como botones de opción. Las integraciones del SDK Lite deben agregar una llamada a `mountExternalButtons`; las integraciones del SDK Full no se ven afectadas.\
  [Guía de migración →](https://docs.y.uno/es/changelog/migration-guides/web/v1-4-to-v1-5.md)

## v1.4.0

*15 de octubre de 2025*

* ADDED **Mensajes de comprobante en pagos con tarjeta**\
  Se agregaron mensajes de comprobante para los pagos con tarjeta, que dan a los clientes una confirmación clara y los detalles de la transacción inmediatamente después de un pago exitoso.

* ADDED **Idioma personalizado para el loader**\
  El loader de Yuno ahora acepta una propiedad `language`, que permite controlar de forma explícita el idioma de la interfaz con independencia de la configuración del navegador. Útil en entornos multilingües.

> [accordion] Definir el idioma al inicializar
>
> ```js theme={"theme":{"light":"github-dark","dark":"github-dark-dimmed"}}
> Yuno.initialize({
>   language: 'es',
> });
> ```

* CHANGED **Mejor renderizado de Click-to-Pay**\
  Mejora la compatibilidad de renderizado de los elementos de Click-to-Pay (C2P) y agiliza el checkout con tarjetas inscritas.

**PayPal**

* ADDED **Inscripción en cuotas de PayPal**\
  Los clientes ahora pueden inscribirse en planes de cuotas de PayPal directamente desde el flujo de pago de PayPal, lo que ofrece opciones de pago flexibles en el checkout.

* ADDED **Redirección de PayPal con botón externo**\
  PayPal ahora puede integrarse mediante un flujo de redirección con botones externos, lo que da a los comercios mayor flexibilidad para construir su interfaz de pago.

## v1.3.0

*20 de marzo de 2025*

* ADDED **Agrupación inteligente de métodos de pago**\
  Cuando un cliente tiene un método de pago inscrito, todos los demás métodos disponibles se agrupan en una lista desplegable plegable llamada "Más opciones". El método inscrito se muestra de forma destacada por defecto.

* ADDED **Compatibilidad con idiomas europeos y asiáticos**\
  Se agregó compatibilidad con alemán (`de`), neerlandés (`nl`), sueco (`sv`), francés (`fr`), italiano (`it`), japonés (`ja`) y coreano (`ko`). Pasa el código correspondiente mediante el parámetro de inicialización `language`.

* FIXED **Correcciones generales de errores**\
  Se resolvieron varios problemas de estabilidad para mejorar la confiabilidad en los flujos de pago.

* CHANGED **Mejor estilo y marca**\
  Mejora la consistencia visual y amplía las opciones de personalización en los componentes del checkout.

## v1.2.0

*20 de febrero de 2025*

* ADDED **Opciones de inicialización opcionales**\
  Se agregó un parámetro opcional `options` a `Yuno.initialize` para equipos con casos de uso avanzados, como el manejo de sesiones personalizado o requisitos de seguimiento.

* CHANGED **Parámetros ampliados de continuePayment**\
  `continuePayment` ahora acepta `checkoutSession`, `showPaymentStatus`, `yunoPaymentResult`, `yunoError`, `countryCode` y `language`, lo que permite sobrescribir la configuración durante la continuación del pago sin reiniciar el checkout.

> [accordion] continuePayment con sobrescrituras
>
> ```js theme={"theme":{"light":"github-dark","dark":"github-dark-dimmed"}}
> yuno.continuePayment({
>   checkoutSession: '438413b7-4921-41e4-b8f3-28a5a0141638',
>   showPaymentStatus: true,
>   yunoPaymentResult: (status) => {
>     console.log('Payment completed with status:', status);
>   },
>   yunoError: (message, data) => {
>     console.error('Payment error:', message, data);
>   },
>   countryCode: 'US',
>   language: 'en',
> });
> ```

* ADDED **Compatibilidad con más de 21 idiomas**\
  Se amplió la cobertura de idiomas a más de 21 configuraciones regionales, incluidos chino simplificado (`zh-CN`), chino tradicional (`zh-TW`), vietnamita (`vi`), ruso (`ru`), turco (`tr`), polaco (`pl`) y más. Pasa el código de idioma al parámetro `language` en `startCheckout`.

**Lite Web SDK**

* ADDED **Sobrescrituras de continuePayment en el SDK Lite**\
  El método `continuePayment` del SDK Lite ahora acepta las mismas sobrescrituras de configuración disponibles en el SDK Full, lo que permite cambiar de forma dinámica la sesión, el idioma y los callbacks durante la continuación del pago.

> [accordion] continuePayment con sobrescrituras en el SDK Lite
>
> ```js theme={"theme":{"light":"github-dark","dark":"github-dark-dimmed"}}
> if (paymentResponse.checkout?.sdk_action_required) {
>   await yuno.continuePayment({
>     countryCode: 'DE',
>     language: 'de',
>     showPaymentStatus: false,
>     yunoPaymentResult: (status) => {
>       console.log('Payment continued with result:', status);
>     },
>     yunoError: (message, data) => {
>       console.error('Payment error:', message, data);
>     },
>   });
> }
> ```

* ADDED **Compatibilidad ampliada de idiomas en el SDK Lite**\
  El SDK Lite v1.2 agrega compatibilidad con más de 18 configuraciones regionales (frente a 7 en v1.1), incluidos códigos de idioma europeos y asiáticos como `de`, `fr`, `it`, `ja`, `ko`, `ru` y `zh-CN`.

## v1.1.0

*20 de enero de 2025*

* BREAKING **Métodos asíncronos del SDK**\
  Los métodos `initialize()`, `mountCheckout()` y `startCheckout()` ahora devuelven Promises. Agrega `await` o `.then()` a cada llamada; el uso síncrono dejará de funcionar.\
  [Guía de migración →](https://docs.y.uno/es/changelog/migration-guides/web/v1-0-to-v1-1.md)

> [accordion] Inicialización asíncrona (v1.1)
>
> ```js theme={"theme":{"light":"github-dark","dark":"github-dark-dimmed"}}
> const yuno = await Yuno.initialize(PUBLIC_API_KEY);
> await yuno.startCheckout(config);
> ```

* ADDED **Método continuePayment**\
  Se introdujo `continuePayment()` para manejar flujos de pago complejos. Llámalo cuando la respuesta de la API incluya `checkout.sdk_action_required: true`; el SDK renderiza entonces automáticamente los desafíos 3DS, los pasos de billeteras externas o las redirecciones según sea necesario.

> [accordion] Manejar sdk\_action\_required con continuePayment
>
> ```js theme={"theme":{"light":"github-dark","dark":"github-dark-dimmed"}}
> const yuno = await Yuno.initialize(PUBLIC_API_KEY);
>
> await yuno.startCheckout(config);
>
> if (paymentResponse.checkout?.sdk_action_required) {
>   const result = await yuno.continuePayment();
> }
> ```

* CHANGED **Integración simplificada de 3DS**\
  La recopilación de datos y la configuración de 3DS ahora se incluyen en el paso de creación del pago. Elimina cualquier llamada independiente al servicio de configuración de 3DS; implementa en su lugar los callbacks `continuePayment()` y `yunoPaymentResult()`.

* ADDED **Compatibilidad con Boleto Bancário**\
  Boleto Bancário ahora está disponible para los comercios que operan en Brasil, lo que amplía las opciones de pago locales para los clientes que prefieren métodos de pago sin conexión.

* CHANGED **Las tarjetas híbridas se procesan como crédito por defecto**\
  Las tarjetas híbridas brasileñas ahora se procesan como crédito por defecto, lo que mejora las tasas de autorización para los comercios con sede en Brasil.

* ADDED **Integración de seguridad con Airwallex**\
  Se integró Airwallex como una capa de seguridad adicional para los pagos web, lo que refuerza la protección contra el fraude sin requerir configuración adicional.

* ADDED **Prevención de fraude con Forter**\
  Se integró la tecnología de prevención de fraude de Forter. El SDK recopila automáticamente las señales del dispositivo; no se requiere una configuración aparte.

* ADDED **Compatibilidad con 3DS de Checkout.com**\
  Se agregó compatibilidad con Checkout.com como proveedor de 3DS. El SDK renderiza automáticamente la página de autenticación cuando el proveedor de la transacción es `checkout3ds`.

* ADDED **Compatibilidad con 3DS de Unlimit**\
  Se introdujo la compatibilidad con la autenticación 3DS para los pagos con Unlimit, lo que refuerza la prevención de fraude para los comercios que usan el proveedor Unlimit.

* ADDED **Mejoras de Click-to-Pay**\
  Los términos y condiciones y los logotipos de tarjeta ahora se actualizan dinámicamente según la tarjeta seleccionada. Las opciones de C2P se ocultan para las tarjetas no compatibles. Se agregó un campo de número de teléfono para el registro en C2P. Los ajustes de cumplimiento de `privacy` y `tnc` se reenvían con cada tarjeta.

* ADDED **Ingreso de tarjeta en línea**\
  Los clientes ahora pueden ingresar los datos de la tarjeta directamente debajo de la opción Tarjeta sin pasar a otra pantalla. Los campos se conservan al cambiar de método de pago, y el flujo es totalmente compatible con las cuotas y el selector de tarjeta.

**Lite Web SDK**

* ADDED **Lanzamiento inicial del SDK Lite**\
  Se lanzó el Lite Web SDK (v1.1), una integración simplificada que ofrece los métodos de pago esenciales, compatibilidad con `initialize()` asíncrono y los callbacks principales (`yunoPaymentResult`, `yunoError`) con una configuración más sencilla.

> [accordion] Checkout básico con el SDK Lite
>
> ```js theme={"theme":{"light":"github-dark","dark":"github-dark-dimmed"}}
> const yuno = await Yuno.initialize(PUBLIC_API_KEY);
>
> yuno.startCheckout({
>   checkoutSession: '438413b7-4921-41e4-b8f3-28a5a0141638',
>   elementSelector: '#root',
>   countryCode: 'FR',
>   language: 'fr',
>   showLoading: true,
>   issuersFormEnable: true,
>   showPaymentStatus: true,
>   card: {
>     isCreditCardProcessingOnly: true,
>   },
>   onLoading: (args) => {
>     console.log(args);
>   },
>   yunoPaymentResult: (status) => {
>     console.log('Payment result:', status);
>   },
>   yunoError: (message, data) => {
>     console.error('Payment error:', message, data);
>   },
> });
> ```

## v1.0.3

*26 de mayo de 2026*

**Core SDK**

* FIXED **Actualizaciones resilientes del estado del pago**\
  Si falla la inicialización de WebSocket (interrupción de red, puerto bloqueado, restricción del navegador), el SDK ahora registra el error y recurre al sondeo HTTP para obtener el estado del pago en lugar de bloquear el checkout. No se requieren cambios en la integración.

## v1.0.0

*1 de enero de 2025*

**Core SDK**

* ADDED **Lanzamiento inicial del SDK**\
  Primera versión estable del Yuno Web SDK. Ofrece cuatro variantes de integración: Full Checkout SDK, Lite Checkout SDK, Seamless SDK y Headless SDK, que cubren una amplia gama de necesidades de personalización de la interfaz.

* ADDED **Métodos de pago principales**\
  Compatibilidad lista para usar con tarjetas de crédito y débito, billeteras digitales (PayPal, Apple Pay, Google Pay), transferencias bancarias, débitos directos y métodos de pago locales regionales en varias monedas y países.

* ADDED **Tres modos de integración**\
  El SDK puede cargarse mediante una etiqueta HTML `<script>`, con JavaScript dinámico o como módulo npm (`@yuno-payments/sdk-web`), lo que admite flujos de trabajo tanto clásicos como de frameworks modernos de JavaScript.

* ADDED **Compatibilidad con siete idiomas**\
  La compatibilidad internacional inicial incluye español (`es`), inglés (`en`), portugués (`pt`), filipino (`fil`), indonesio (`id`), malayo (`ms`) y tailandés (`th`).

* ADDED **Métodos principales del SDK**\
  Ofrece `Yuno.initialize()`, `startCheckout()`, `mountCheckout()` y `startPayment()` como la superficie básica de la API. Todos los métodos son síncronos en v1.0.

> [accordion] Inicialización del checkout Full (v1.0)
>
> ```js theme={"theme":{"light":"github-dark","dark":"github-dark-dimmed"}}
> const yuno = Yuno.initialize(PUBLIC_API_KEY);
>
> yuno.startCheckout({
>   checkoutSession: '438413b7-4921-41e4-b8f3-28a5a0141638',
>   elementSelector: '#root',
>   country_code: 'FR',
>   language: 'fr',
>   showLoading: true,
>   issuersFormEnable: true,
>   showPaymentStatus: true,
>   card: {
>     isCreditCardProcessingOnly: true,
>   },
>   onLoading: (args) => {
>     console.log(args);
>   },
>   yunoPaymentMethodSelected: () => {
>     console.log('Payment method selected');
>   },
>   yunoPaymentResult: (status) => {
>     console.log('Payment result:', status);
>   },
>   yunoError: (message, data) => {
>     console.error('Payment error:', message, data);
>   },
> });
> ```


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.