SDK Web v1.1 Changelog

• Date de sortie: Début 2025
• Statut: Version précédente (remplacée par v1.2)

Nouveautés de la version 1.1

La version 1.1 représente une évolution majeure du SDK Web de Yuno, introduisant des opérations asynchrones, des flux de paiement améliorés et des améliorations significatives des performances pour les applications Web modernes.

Mises à jour asynchrones des méthodes

Les méthodes clés du SDK prennent désormais en charge les opérations basées sur des promesses pour une meilleure intégration avec les cadres JavaScript modernes.

1. Méthodes fondées sur des promesses: Des méthodes clés telles que initialize(), mountCheckout()et  startCheckout() renvoient désormais des promesses. Ce changement permet de mieux gérer les flux dynamiques tels que les 3DS, les redirections PayPal et le rendu personnalisé de l'interface utilisateur.

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

Améliorée continuePayment Méthode

Le champ continuePayment devient essentielle pour gérer des flux de paiements complexes et garantir l'exécution des paiements.

2. Continuation des paiements critiques: Avec l'introduction de nouvelles méthodes de paiement et de flux dynamiques dans le SDK v1.1, la continuePayment est devenue plus importante pour compléter les expériences de paiement des clients après la création du paiement.

   • Quand utiliser: Lorsque la réponse de l'API comprend sdk_action_required: trueVous devez appeler continuePayment pour reprendre le processus
   • Traitement automatique: Le SDK affiche automatiquement les écrans nécessaires (authentification 3DS, étapes du portefeuille externe).
   • Comportement de retour: Peut renvoyer un objet de redirection pour le traitement côté marchand, sinon renvoie null

Améliorations 3DS (5 juin 2025)

Rationalisation du processus d'authentification 3DS avec une fiabilité accrue et des exigences d'intégration simplifiées.

3. Intégration 3DS simplifiée: Mise à jour du flux 3DS pour augmenter la fiabilité et simplifier l'intégration :

   • Pas de service d'installation séparé: La collecte et la configuration des données 3DS sont désormais incluses dans la création du paiement.
   • Transactions asynchrones: Toutes les transactions 3DS utilisent la redirection pour les informations sur les appareils et les défis.
   • Mise en œuvre obligatoire: Doit être mis en œuvre continuePayment()  et  yunoPaymentResult() après la création du paiement
   • Optimisation des performances: Déclencheurs SDK collect n'intervenir que lorsque le 3DS est nécessaire

Amélioration des performances

Optimisations complètes de toutes les opérations SDK pour un traitement des paiements plus rapide et plus fiable.

4. Flux optimisés:
   • Réduction des appels d'API inutiles
   • Amélioration des performances globales
   • Une meilleure cohérence visuelle
   • Fonctions de sécurité renforcées

Comportement dynamique "cliquer pour payer" (C2P)

Amélioration de la fonctionnalité "click-to-pay" avec une meilleure expérience utilisateur et une prise en charge des comportements dynamiques.

5. C2P amélioré: Amélioration complète de la fonctionnalité "click-to-pay" :
   • Les conditions générales et les logos sont mis à jour de manière dynamique en fonction de la carte.
   • Les options C2P sont cachées pour les cartes non prises en charge
   • Ajout d'un champ pour le numéro de téléphone lors de l'enregistrement
   • Paramètres de conformité pour privacy  et  tnc (conditions générales) sont désormais transmises avec la carte

Améliorations de l'interface utilisateur

Amélioration significative de la conception des formulaires de paiement et de l'expérience utilisateur.

6. Amélioration de la visualisation des cartes enrôlées:

   • Des visuels de cartes génériques apparaissent désormais pour Visa et Mastercard
   • American Express affiche le CVV au recto de la carte
   • La visualisation de la carte se retourne dynamiquement en fonction de la focalisation du champ CVV
   • Les titres dynamiques s'adaptent aux données saisies par les utilisateurs
   • Le sélecteur d'installation a été redessiné pour améliorer l'interface utilisateur sur les téléphones portables et les ordinateurs de bureau.
   • Un style et un comportement cohérents sur toutes les plateformes

7. Amélioration de la présentation:

   • Correction du chevauchement entre les champs "type de document" et "versement".
   • La mise en page s'ajuste désormais correctement lors de la validation

8. Mode de paiement présélectionné:

   • Présélectionne automatiquement le dernier mode de paiement utilisé (ou le premier mode de paiement configuré).
   • Traitement sans erreur des méthodes invalides ou supprimées

9. Gestion des modes de paiement enregistrés:

   • Les utilisateurs peuvent désormais supprimer les méthodes de paiement enregistrées directement dans l'interface du SDK.

10. Entrée de carte en ligne:

    • Les utilisateurs peuvent désormais saisir les détails de la carte directement sous l'option Carte.
    • Compatibilité totale avec les flux existants, tels que les paiements échelonnés et le sélecteur de cartes
    • Les champs persistent lorsque l'on change de méthode

Améliorations techniques

Amélioration du backend et de l'intégration pour une meilleure fiabilité et fonctionnalité.

11. PayPal Fallback Client ID:

    • Lorsque le PayPal clientId n'est pas fourni dans la configuration du commerçant, le SDK utilise la solution de remplacement de l'option paymentByCheckoutSession réponse du endpoint

12. Style de caisse flexible:

    • Les éléments d'actions flexibles prennent désormais en charge le style personnalisé transmis par le biais de la fonction UI dans l'objet getPaymentByCheckout réponse
    • Veiller à la cohérence de la conception sur toutes les plates-formes et tous les appareils

13. Suppression des champs obsolètes:

    • Suppression de l'élément inutilisé gender du SDK et la configuration des champs obligatoires

14. Mises à jour de l'écran d'état:

    • Amélioration de l'aspect visuel de tous les écrans d'état, ce qui leur confère une apparence plus nette.

Amélioration de la sécurité et des méthodes de paiement

De nouvelles intégrations de sécurité et une prise en charge élargie des méthodes de paiement.

15. Nouvelles intégrations de sécurité:

    • Airwallex: ajoute une couche de sécurité supplémentaire pour le web
    • Forter (Web): Protection renforcée des paiements grâce à la technologie de prévention des fraudes de Forter
    • Commander la 3DS: Prise en charge d'un nouveau fournisseur 3D Secure. Affiche la page d'authentification lorsque le fournisseur de transaction est checkout3ds
    • Unlimit 3DS: Introduction du support 3DS pour les paiements Unlimit, améliorant l'authentification et la prévention de la fraude.

16. Amélioration des paiements brésiliens:

    • Cartes hybrides: Les cartes hybrides sont désormais traitées comme des cartes de crédit par défaut, ce qui améliore la conversion pour les commerçants basés au Brésil.
    • Nouvelle méthode de paiement Boleto: Le Boleto Bancário est désormais disponible pour tous les marchands opérant au Brésil, ce qui élargit les options de paiement locales et améliore la conversion pour les utilisateurs qui préfèrent les méthodes hors ligne.

Changements dans la mise en œuvre

Changements architecturaux importants nécessitant des mises à jour des intégrations existantes.

Changements par rapport à la version 1.0

• Méthodes asynchrones: Toutes les méthodes principales renvoient désormais des promesses et requièrent await
• continuePayment l'importance: Désormais critique pour les flux d'exécution des paiements
• Changements dans le flux 3DS: L'installation séparée de la 3DS n'est plus nécessaire

Étiquette de script

Mise à jour de la source du script pour la v1.1 avec une nouvelle structure d'URL :

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

Exemple de migration

Comparaison montrant les principales différences entre les implémentations v1.0 et 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
}

Migration depuis la version 1.0

Etapes essentielles pour la mise à jour des implémentations v1.0 existantes vers la v1.1.

Changements requis :

1. Mise à jour de la source du script à la version 1.1
2. Ajouter await à initialize(), mountCheckout()et  startCheckout() appels
3. Mettre en œuvre continuePayment() traitement des flux de paiement dynamiques
4. Garantir yunoPaymentResult() le callback est correctement configuré
5. Suppression de tout appel au service de configuration de 3DS

Calendrier :

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

📘

Ressources complémentaires

Pour obtenir des conseils et des exemples de mise en œuvre, consultez la page de documentation du SDK Web et le dépôt GitHub pour plus d'informations.

Ce qui est obsolète dans la v1.1

Fonctionnalités et modèles qui ne sont plus recommandés ou pris en charge dans la version 1.1.

• Service séparé de mise en place de 3DS: N'est plus nécessaire ; intégré dans la création du paiement
• Appels de méthodes synchrones: Les méthodes renvoient désormais des promesses et doivent utiliser await
• Gestion manuelle des flux 3DS: Le SDK gère désormais automatiquement les flux 3DS