Saltar al contenido principal
En esta página

Los ejemplos de documentación actualmente están fijados https://cdn.deuna.io/web-sdk/v1.7/index.jsFijar una versión en producción, validarla en sandbox y desplegar el cambio de URL a través de su proceso de lanzamiento normal.

Flujo de actualización#

01 · inventory
Registrar el comportamiento actual
URL del SDK para captura, experiencias habilitadas, callbacks, CSP y matriz de navegadores.
02 · sandbox
Cambiar la versión fijada
Actualizar un entorno controlado y borrar la caché de la aplicación.
03 · verify
Ejecutar la matriz de pagos
Probar tarjetas, billeteras, APMs, 3DS, cerrar, errores, anchos de dispositivos móviles y accesibilidad.
04 · release
Monitorizar la producción
Supervisar los errores del cliente y los resultados de pago en el backend.

Versiones destacadas#

v1.7.0 · 9 de septiembre de 2026Línea documentada actual

Modificado

  • Migrado el marco de widgets interno.
  • Actualizado el gestor de paquetes y las herramientas de construcción utilizadas para publicar el paquete del navegador.

Verificar al actualizar

  • Creación de modales, renderizado de destino integrado, onResize, pre-carga y cierre.
  • Todos los tipos de widgets habilitados: Pago, Elementos, Voucher y Acción Siguiente.
  • CSP y caché de la aplicación contra el nuevo paquete fijado.
v1.6.1 · 2 de septiembre de 2026Reforzamiento de modales e idempotencia

Añadido y protegido

  • Mejorado el manejo del redireccionamiento de modales de la página padre y los eventos de ciclo de vida de modales externos.
  • Añadido errorApmMissingReference soporte de errores.
  • Añadido soporte de idempotencia para la protección de autorización duplicada en los flujos compatibles.
  • Reforzado la gestión de modales y el comportamiento entre orígenes.

Verificar al actualizar

  • 3DS y cada APM redirigido configurado en condiciones de popup del navegador.
  • Cierre del cliente, cierre del popup, tiempo de espera y comportamiento de retorno al checkout.
  • Su código no depende de leer un popup entre orígenes.
v1.6.0 · 10 de junio de 2026Comportamiento de visibilidad de la tarjeta guardada
  • Añadido una opción de comportamiento compatible para ocultar las tarjetas del cliente en las experiencias aplicables.
  • Probar los flujos autenticados y de identidad de invitado siempre que se cambie la visibilidad de la tarjeta guardada.
Línea pública anteriorExperiencias del Core Web SDK

La línea pública anterior estableció el widget de pago, los elementos, el almacenamiento de tarjetas, la generación de datos del dispositivo, Apple Pay, Google Pay y el marco de widgets SDK. Actualice a través del entorno de pruebas, en lugar de asumir el comportamiento actual de la llamada de retorno y la ventana emergente en el paquete anterior.

Contrato de compatibilidad#

SuperficieExpectativa de actualización
Ruta principal/menor del CDNSolo se modifica cuando el comerciante actualiza la URL del script.
Callbacks dedicadosSuperficie de integración estable preferida; compile o ejecute cada manejador después de la actualización.
Cargas de eventosEspecíficas para la experiencia y más propensas a obtener campos. Evite la igualdad estricta de objetos completos.
Nombres de eventosPueden expandirse. Mantenga una opción de respaldo para eventos desconocidos.
Interfaz de usuario alojadaPuede evolucionar dentro del contrato de tema compatible. Pruebe capturas de pantalla como señales, no contratos DOM exactos.
DOM privado, estructura iframe y shadow-rootNo es una API de integración. No la consulte ni la modifique.

Lista de verificación de regresión#

  • Éxito y fallo de carga bajo el CSP equivalente de producción.
  • initialize Una vez, múltiples rutas y aislado newInstance() Utilice si es aplicable.
  • Widget y elementos de pago en modos de ventana modal y embebido.
  • Pre-cargado y apertura bajo demanda.
  • Controlado isValid() y submit() flow.
  • BIN, instalación, procesamiento, éxito, error, cerrar, redimensionar y callbacks de eventos.
  • Disponibilidad de Apple Pay y Google Pay, más lanzamiento con gesto del cliente.
  • Ciclo de vida externo de 3DS y APM.
  • Mostrar o descargar vales y confirmación de pedido asíncrona.
  • Ancho de 320 px para dispositivos móviles, uso solo con teclado, lector de pantalla y reducción de movimiento.