Registro de cambios del SDK web v1.0

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

Novedades de la v1.0

La versión inicial del SDK Web de Yuno introduce amplias capacidades de integración de pago con soporte para múltiples tipos de SDK, métodos de pago y enfoques de integración.

Lanzamiento inicial

La versión básica del SDK web de Yuno, que ofrece una funcionalidad completa pago en diferentes patrones de integración.

Funciones principales del SDK

Yuno v1.0 incluye cuatro enfoques SDK distintos para satisfacer diferentes necesidades de integración:

1. SDK de pago completo: Formulario de pago completo con múltiples métodos de pago e interfaz de usuario completa.
2. SDK de pago Lite: Flujo de pago simplificado para integraciones más sencillas
3. Seamless SDK: Componentes de pago personalizables para experiencias de marca
4. Headless SDK: Enfoque API-first para implementaciones de interfaz de usuario personalizadas.

método de pago Soporte

Asistencia completa para métodos de pago globales y regionales:

• Tarjetas de crédito y débito
• Monederos digitales (PayPal, Apple Pay, Google Pay)
• Transferencias y domiciliaciones bancarias
• Métodos de pago locales por región
• Múltiples monedas y países

Métodos de integración

Opciones de implantación flexibles para adaptarse a distintos flujos de trabajo de desarrollo:

• Etiqueta de script HTML: Sencilla inclusión de secuencias de comandos para una configuración rápida
• JavaScript dinámico: Carga programática para configuraciones avanzadas
• Módulo NPM: Soporte para la integración de frameworks modernos de JavaScript

Soporte multilingüe

Soporte internacional inicial con siete idiomas:

• Español (es)
• Inglés (en)
• Portugués (pt)
• Filipino (fil)
• Indonesio (id)
• Malayo (ms)
• Tailandés (th)

Implementación

Etiqueta de script

Integración sencilla mediante la inclusión de etiquetas de script HTML estándar:

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

Uso básico

Inicialización sincrónica estándar y proceso de comprobación para v1.0:

// v1.0 synchronous initialization
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);
  },
});

Métodos clave

Métodos básicos disponibles en la versión inicial v1.0:

• Yuno.initialize(): Initialize el SDK con la clave pública de la API
• startCheckout(): Iniciar el proceso de pago con la configuración
• mountCheckout(): Montar formulario de pago a elemento DOM especificado
• startPayment(): Iniciar el flujo de pago tras la selección del cliente

Qué está obsoleto

Esta es la versión inicial - no hay características obsoletas en el lanzamiento.

Notas de migración

Desde versiones beta anteriores

Si actualiza desde cualquier versión previa o beta:

1. Actualizar la fuente del script a la URL de la versión estable v1.0
2. Asegúrese de que todas las llamadas a métodos utilizan las firmas finales de la API v1.0
3. Verificar que la creación de la sesión de pago sigue el formato estable de la API
4. Pruebe a fondo los flujos de pago en su entorno sandbox

De cara al futuro

Aunque la v1.0 proporciona una base sólida, ten en cuenta que:

• La v1.1 introduce métodos asíncronos: Las versiones futuras pasarán a API basadas en promesas
• Flujos de pago mejorados: Las versiones posteriores añadirán métodos de continuación de pago mejorados
• Cambios en la integración de 3DS: Las próximas versiones agilizarán la configuración y el manejo de 3DS

Para obtener la información más actualizada, consulte siempre la documentación más reciente del SDK y considere la posibilidad de planificar futuras migraciones de versión.