Registro de cambios del SDK web v1.1

• Fecha de publicación: Principios de 2025
• Estado: Versión anterior (sustituida por la v1.2)

Novedades de la v1.1

La versión 1.1 representa una importante evolución del SDK Web de Yuno, introduciendo operaciones asíncronas, flujos de pago mejorados y mejoras significativas en el rendimiento de las aplicaciones web modernas.

Actualizaciones de métodos asíncronos

Los métodos clave del SDK ahora admiten operaciones basadas en promesas para una mejor integración con los marcos de trabajo modernos de JavaScript.

1. Métodos basados en promesas: Métodos clave como initialize(), mountCheckout()y startCheckout() Ahora se devuelven promesas. Este cambio facilita la gestión de flujos dinámicos como 3DS, redirecciones de PayPal y renderizado de interfaz de usuario personalizado.

// v1.1 async implementation
const yuno = await Yuno.initialize(PUBLIC_API_KEY)

Mejorado continuePayment Método

El objeto continuePayment resulta esencial para gestionar flujos de pago complejos y garantizar la finalización pago.

2. pago Continuación: Con la introducción de nuevos métodos de pago y flujos dinámicos en SDK v1.1, el continuePayment se hizo más importante para completar las experiencias de pago los clientes tras la creación pago.

   • Cuándo utilizar: Cuando la respuesta de la API incluye sdk_action_required: true, debes llamar continuePayment para reanudar el proceso
   • Gestión automática: El SDK renderiza automáticamente las pantallas necesarias (autenticación 3DS, pasos de monedero externo)
   • Comportamiento de retorno: Puede devolver un objeto de redirección para la gestión del lado del comerciante; de lo contrario, devuelve null

Mejoras 3DS (5 de junio de 2025)

Proceso de autenticación 3DS racionalizado con mayor fiabilidad y requisitos de integración simplificados.

3. Integración 3DS simplificada: Flujo 3DS actualizado para aumentar la fiabilidad y simplificar la integración:

   • Sin servicio de configuración independiente: La recogida y configuración de datos 3DS ahora se incluye en la creación del pago
   • Transacciones asíncronas: Todas las transacciones 3DS utilizan la redirección para la información del dispositivo y los desafíos
   • Aplicación requerida: Debe aplicarse continuePayment() y yunoPaymentResult() después de la creación del pago
   • Optimización del rendimiento: Activadores SDK collect paso sólo cuando se requiere 3DS

Mejoras de rendimiento

Amplias optimizaciones en todas las operaciones del SDK para un procesamiento de pago más rápido y fiable.

4. Flujos optimizados:
   • Reducción de las llamadas innecesarias a la API
   • Mejora del rendimiento general
   • Mayor coherencia visual
   • Funciones de seguridad mejoradas

Comportamiento dinámico Click-to-Pay (C2P)

Funcionalidad click-to-pay mejorada con experiencia de usuario mejorada y soporte de comportamiento dinámico.

5. C2P mejorado: Mejoras integrales en las funciones de pago por clic:
   • Los términos y condiciones y los logotipos se actualizan dinámicamente en función de la tarjeta
   • Las opciones C2P están ocultas para las tarjetas no compatibles
   • Se ha añadido un campo de número de teléfono para el registro
   • Configuraciones de cumplimiento para privacy y tnc (términos y condiciones) se transmiten ahora junto con la tarjeta

Mejoras en la interfaz de usuario

Mejoras significativas en el diseño del formulario de pago y en la experiencia del usuario.

6. Mejoras en la visualización de tarjetas inscritas:

   • Ahora aparecen imágenes genéricas de tarjetas Visa y Mastercard
   • American Express muestra el CVV en el anverso de la tarjeta
   • La visualización de la tarjeta cambia dinámicamente en función del enfoque del campo CVV
   • Los títulos dinámicos se adaptan a las entradas introducidas por los usuarios
   • Selector de plazos rediseñado para mejorar la experiencia de usuario en móviles y ordenadores de sobremesa.
   • Estilo y comportamiento coherentes en todas las plataformas

7. Mejoras en el trazado:

   • Corrección del solapamiento entre el tipo de documento y los campos de plazos
   • Ahora el diseño se ajusta adecuadamente durante la validación.

8. Método de pago preseleccionado:

   • Preselecciona automáticamente el último método de pago utilizado (o el primero configurado)
   • Gestión sin errores de métodos no válidos o eliminados

9. Inscrito pago Método Gestión:

   • Ahora los usuarios pueden eliminar los métodos de pago guardados directamente en la interfaz del SDK.

10. Entrada de tarjeta en línea:

    • Ahora los usuarios pueden introducir los datos de la tarjeta directamente debajo de la opción Tarjeta
    • Compatibilidad total con los flujos existentes, como los pagos a plazos y el selector de tarjetas
    • Los campos persisten al cambiar de método

Mejoras técnicas

Mejoras en el backend y la integración para aumentar la fiabilidad y la funcionalidad.

11. Id. de cliente de Fallback de PayPal:

    • Cuando el PayPal clientId no se proporciona en la configuración del comerciante, el SDK utiliza el fallback del paymentByCheckoutSession respuesta endpoint

12. Estilo de pago flexible:

    • Los elementos de Acciones flexibles ahora admiten estilos personalizados que se pasan a través del objeto UI en la respuesta getPaymentByCheckout respuesta
    • Garantiza un diseño coherente en todas las plataformas y dispositivos

13. Eliminación de campos obsoletos:

    • Se eliminó el campo gender del SDK y la configuración de los campos obligatorios

14. Actualizaciones de la pantalla de estado:

    • Mejoras visuales en todas las pantallas de estado, que proporcionan un aspecto más limpio.

Mejoras en la seguridad y el método de pago

Nuevas integraciones de seguridad y mayor compatibilidad con métodos de pago.

15. Nuevas integraciones de seguridad:

    • Airwallex: añade una capa de seguridad adicional para la web
    • Forter (Web): Mayor protección pago gracias a la tecnología de prevención del fraude de Forter
    • Caja 3DS: Nuevo proveedor 3D Secure compatible. Representa la página de autenticación cuando el proveedor de transacciones está... checkout3ds
    • Unlimit 3DS: Se introduce la compatibilidad con 3DS para los pagos Unlimit, lo que mejora la autenticación y la prevención del fraude.

16. pago brasileño Mejoras:

    • Tarjetas híbridas: Ahora se procesan como crédito por defecto, lo que mejora la conversión para los comercios de Brasil.
    • Nuevo método de pago Boleto: Boleto Bancário está ahora disponible para todos los comerciantes que operan en Brasil, ampliando las opciones de pago local y mejorando la conversión para los usuarios que prefieren métodos offline.

Cambios en la aplicación

Cambios arquitectónicos significativos que requieren actualizaciones de las integraciones existentes.

Cambios con respecto a la v1.0

• Métodos asíncronos: Todos los métodos principales ahora devuelven Promesas y requieren await
• continuePayment importancia: Ahora crítico para los flujos de pago
• Cambios en el flujo de 3DS: Ya no es necesario configurar la 3DS por separado

Etiqueta de script

Fuente de script actualizada para v1.1 con nueva estructura de URL:

<script src="https://sdk-web.y.uno/v1.1/main.js"></script>

Ejemplo de migración

Comparación que muestra las principales diferencias entre las implementaciones v1.0 y v1.1:

// v1.0 (synchronous)
const yuno = Yuno.initialize(PUBLIC_API_KEY);
yuno.startCheckout(config);

// v1.1 (asynchronous) 
const yuno = await Yuno.initialize(PUBLIC_API_KEY);
await yuno.startCheckout(config);

// Essential: Implement continuePayment for dynamic flows
if (paymentResponse.sdk_action_required) {
  const result = await yuno.continuePayment();
  // Handle result appropriately
}

Migración desde v1.0

Pasos esenciales para actualizar las implantaciones existentes de la v1.0 a la v1.1.

Cambios necesarios:

1. Actualizar la fuente del script a v1.1
2. Agregar await a initialize(), mountCheckout()y startCheckout() llama a
3. Implementar continuePayment() gestión de flujos de pago dinámicos
4. Asegúrese yunoPaymentResult() está configurado correctamente
5. Eliminar las llamadas al servicio de configuración de 3DS

Calendario:

• Cajón de arena: Cambios activos a partir del 5 de junio de 2025
• Producción: Cambios activos a partir del 5 de septiembre de 2025

📘

Recursos adicionales

Para obtener más información sobre la implementación y ejemplos, visite la página de documentación del SDK web y el repositorio de GitHub.

Lo que ha quedado obsoleto en la v1.1

Funciones y modelos que ya no se recomiendan o no son compatibles con la versión 1.1.

• Servicio independiente de creación de 3DS: Ya no es necesario; se integra en la creación de pago
• Llamadas a métodos síncronos: Los métodos ahora devuelven Promesas y deben usar await
• Gestión manual de 3DS: SDK ahora maneja los flujos 3DS automáticamente