Aller au contenu principal
Tous les systèmes sont opérationnelsNouveautésv1
Se connecter
Web SDK

Versions du SDK Web

Suivez la compatibilité du SDK Web DEUNA, les modifications publiques notables et un processus de mise à niveau sûr pour les intégrations CDN fixes.

Dernière mise à jour : October 16, 2026
Sur cette page

Les exemples de documentation sont actuellement fixés https://cdn.deuna.io/web-sdk/v1.7/index.jsFixez une version en production, validez-la en sandbox et déployez le changement d'URL via votre processus de publication normal.

Flux de mise à niveau#

01 · inventory
Enregistrez le comportement actuel
Capturez l'URL du SDK, les expériences activées, les callbacks, CSP et la matrice de navigateurs.
02 · sandbox
Changez la version fixée
Mettez à niveau un environnement contrôlé et effacez les caches d'application.
03 · verify
Exécutez la matrice de paiement
Testez les cartes, les wallets, les APMs, 3DS, la fermeture, les erreurs, les largeurs mobiles et l'accessibilité.
04 · release
Surveillez la production
Observez les erreurs du client et les résultats de paiement en arrière-plan ensemble.

Versions notables#

v1.7.0 · 9 septembre 2026Ligne documentée actuelle

Mis en œuvre

  • Migration du framework de widget interne.
  • Mise à jour des outils de gestion de paquets et de construction utilisés pour publier le bundle de navigateur.

Vérification lors de la mise à niveau

  • Création de modales, rendu de cible intégré, onResizepréchargement et fermeture.
  • Tous les types de widgets activés : Paiement, Éléments, Voucher et Prochaine Action.
  • CSP et mise en cache de l'application pour le nouveau bundle.
v1.6.1 · 2 septembre 2026Renforcement des modales et de l'idempotence

Ajout et sécurisation

  • Amélioration de la gestion des redirections de modales vers la page parente et des événements de cycle de vie des modales externes.
  • Ajout errorApmMissingReference support des erreurs.
  • Ajout du support de l'idempotence pour la protection contre l'autorisation en double dans les flux pris en charge.
  • Renforcement de la gestion des modales et du comportement cross-origin.

Vérification lors de la mise à niveau

  • 3DS et tous les APM redirigés configurés dans les conditions de popup du navigateur.
  • Fermeture du client, fermeture de la modale, délai d'attente et comportement de retour vers le checkout.
  • Votre code ne dépend pas de la lecture d'une modale cross-origin.
v1.6.0 · 10 juin 2026Comportement de visibilité de la carte enregistrée
  • Ajout d'une option de comportement prise en charge pour masquer les cartes des clients dans les expériences applicables.
  • Testez à nouveau les flux authentifiés et les identités de visiteur lors du changement du comportement de visibilité de la carte enregistrée.
Ligne publique antérieureExpériences Core Web SDK

La ligne publique antérieure a établi le widget de paiement, les éléments, le coffre-fort de cartes, la génération de données de l'appareil, Apple Pay, Google Pay et le framework de widget SDK. Mettez à niveau via le sandbox plutôt que de supposer le comportement actuel des callbacks et des modales sur un ancien bundle.

Contrat de compatibilité#

SurfaceAttentes de mise à niveau
Chemin principal/secondaire du CDN fixéSe modifie uniquement lorsque le commerçant met à jour l'URL du script.
Callbacks dédiésSurface d'intégration stable préférée ; compiler ou tester chaque gestionnaire après la mise à niveau.
Payloads d'événements brutsSpécifiques à l'expérience et plus susceptibles de contenir des champs. Éviter une comparaison stricte de l'égalité des objets.
Noms d'événementsPeut évoluer. Prévoir une gestion des événements inconnus.
Interface utilisateur hébergéePeut évoluer dans le cadre du contrat de thème pris en charge. Tester les captures d'écran comme indicateurs, et non comme des contrats DOM précis.
DOM privé, iframe et structure de shadow-rootN'est pas une API d'intégration. Ne pas la interroger ni la modifier.

Liste de contrôle de régression#

  • Succès et échec de chargement sous CSP équivalent à la production.
  • initialize Une seule fois, plusieurs routes, et isolé newInstance() Utiliser si applicable.
  • Widget et éléments de paiement en mode modal et intégré.
  • Préchargement et ouverture à la demande.
  • Contrôlé isValid() et submit() flow.
  • BIN, échéances, traitement, succès, erreur, fermeture, redimensionnement et callbacks d'événements.
  • Disponibilité d'Apple Pay et de Google Pay, ainsi que le lancement par geste du client.
  • Cycle de vie externe 3DS et APM.
  • Affichage ou téléchargement de bons et confirmation de commande asynchrone.
  • Largeur mobile de 320 px, utilisation uniquement avec le clavier, lecteur d'écran et réduction du mouvement.
CommencerChargement et CSP de base.Widget de paiementIntégration de paiement actuelle.Événements SDKCatégories d'événements actuelles.