Lite Web SDK v1.2 Changelog

  • Date de sortie: Avril 2025
  • Statut: Version précédente (remplacée par v1.3)

Nouveautés de la version 1.2

La version 1.2 s'appuie sur la base rationalisée de Lite v1.1 avec des capacités améliorées de contrôle des flux de paiement et une prise en charge linguistique internationale considérablement élargie.

Améliorée continuePayment Méthode

Des fonctionnalités étendues permettent des modifications dynamiques de la configuration pendant la poursuite du paiement, pour des implémentations plus flexibles.

  1. Prolongé continuePayment Fonctionnalité: A partir de la version 1.2.0, l'application continuePayment accepte désormais des propriétés supplémentaires qui n'étaient auparavant disponibles que dans la méthode startCheckout. Cela vous permet d'ignorer des configurations spécifiques lors de la poursuite d'un paiement.

NOUVEAU continuePayment Propriétés

La liste complète des options de configuration est désormais disponible dans continuePayment:

continuePayment({
  checkoutSession?: string
  showPaymentStatus?: boolean
  yunoPaymentResult?: (status: string) => void
  yunoError?: (message: string, data?: unknown) => void
  countryCode?: string
  language?: string
})

Paramètres améliorés :

  • checkoutSession: Remplacer la session de paiement pour le paiement en cours
  • showPaymentStatus: Permet d'afficher ou non la page d'état des paiements de Yuno.
  • yunoPaymentResult: Rappel personnalisé pour la gestion des résultats de paiement
  • yunoError: Callback personnalisé pour la gestion des erreurs
  • countryCode: Indiquer le code du pays lors de la poursuite du paiement
  • language: Définir la préférence linguistique lors de la poursuite du paiement

Prise en charge linguistique étendue

Couverture linguistique internationale considérablement élargie pour Lite SDK mondiales Lite SDK :

  • Langues principales: Espagnol (es), Portugais (pt), Indonésien (id), Malais (ms), Thaï (th)
  • Langues asiatiques: Philippin (fil), chinois traditionnel (zh-TW), chinois simplifié (zh-CN), vietnamien (vi), coréen (ko), japonais (ja)
  • Langues européennes: Français (fr), Polonais (pl), Italien (it), Allemand (de), Russe (ru), Turc (tr), Néerlandais (nl), Suédois (sv)

Changements dans la mise en œuvre

Considérations importantes pour la mise en œuvre et la migration de Lite v1.2.

Principaux changements par rapport à la version 1.1

  • Améliorée continuePayment: La méthode accepte désormais les dérogations de configuration
  • Options linguistiques étendues: prise en charge de 18 langues contre 7 dans la version 1.1
  • Rétrocompatibilité: Toutes les fonctionnalités de la version 1.1 restent prises en charge

Étiquette de script

Mise à jour de la source du script pour la fonctionnalité v1.2 :

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

Exemple d'utilisation

Démonstration de l'amélioration continuePayment capacités dans Lite SDK:

// Enhanced continuePayment with configuration override
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"
});

Exemple d'implémentation complète

Implémentation complète de Lite v1.2 présentant des capacités améliorées :

// Lite v1.2 implementation with enhanced continuePayment
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);
  },
});

// Enhanced continuePayment with overrides
if (paymentResponse.sdk_action_required) {
  const result = await yuno.continuePayment({
    countryCode: "DE",
    language: "de",
    showPaymentStatus: false,
    yunoPaymentResult: (status) => {
      console.log("Payment continued with result:", status);
    }
  });
}

Migration depuis la v1.1

Mise à niveau fluide sans changement radical depuis Lite v1.1.

Mise à niveau de Lite v1.1 vers v1.2 :

  1. Mise à jour de la source du script à la version 1.2
  2. Il est possible d'exploiter de nouveaux continuePayment paramètres pour un meilleur contrôle
  3. Profitez d'une prise en charge linguistique étendue pour les implémentations internationales.
  4. Pas de changements radicaux - les implémentations existantes continuent de fonctionner

Calendrier de migration

  • Bac à sable: Changements actifs à partir du 5 juin 2025
  • Production: Changements actifs à partir du 5 septembre 2025

Ce qui est obsolète

Version entièrement rétrocompatible sans fonctionnalités obsolètes.

Aucune fonctionnalité n'a été supprimée dans Lite v1.2. Toutes les fonctionnalités précédentes restent disponibles et prises en charge.

Avantages Lite SDK

Le Lite Web SDK .2 conserve son approche simplifiée tout en ajoutant de puissantes fonctionnalités :

  • Complexité simplifiée: fonctionnalités améliorées sans options de configuration trop nombreuses
  • Portée mondiale: prise en charge linguistique étendue pour les marchés internationaux
  • Flux flexibles: Méthode continuePayment pour les scénarios de paiement dynamiques
  • Migration facile: mises à niveau rétrocompatibles à partir de la version 1.1
📘

Lite SDK

Le Lite Web SDK .2 continue d'offrir des fonctionnalités de paiement essentielles avec des capacités améliorées. Pour les commerçants qui ont besoin de fonctionnalités plus avancées ou d'options de personnalisation, envisagez le Full Web SDK pour bénéficier de solutions complètes de traitement des paiements.

📘

Ressources complémentaires

Pour obtenir des conseils de mise en œuvre et des exemples, consultez la Lite Web SDK et le référentiel GitHub pour plus d'informations.