Le client consigne dans la console du navigateur tous les éléments qu’il signale, préfixés par [Entase API]. Commencez par ouvrir la console.
Le paiement s’ouvre dans une fenêtre pop-up au lieu d’un panneau
Les causes habituelles, dans l’ordre où il convient de les vérifier :
- Le domaine n’est pas une origine approuvée. Ajoutez-le dans Paramètres → Intégrations, en respectant le préfixe
www.effectivement utilisé par votre site – voir Intégrations et personnalisation du paiement. - La page n’est pas servie via HTTPS. Le paiement intégré n’est jamais utilisé sur une page non sécurisée.
- Aucune clé publiable. Sans
pk, le client ne peut pas vérifier si le paiement intégré est autorisé ; il conserve donc le mode pop-up. book()s’est exécuté trop tôt. La vérification des autorisations est asynchrone et le mode reste pop-up jusqu’à ce qu’elle réponde. Un paiement ouvert automatiquement au chargement de la page peut la devancer – voir Modes de paiement.connect-srcest bloqué par votre politique de sécurité du contenu, donc la vérification ne se termine jamais. La console affichera la requête bloquée.
entase.getCheckoutMode() indique le mode résolu et constitue le moyen le plus rapide de distinguer les problèmes de configuration des problèmes de timing.
« Mode de paiement par panneau activé pour localhost »
C’est attendu pendant le développement. Le client suppose le mode panneau sur localhost et 127.0.0.1 afin que vous puissiez développer avec la mise en page intégrée, et affiche un avertissement car cette hypothèse ne dit rien de l’environnement de production. Ajoutez votre véritable domaine aux origines approuvées avant la mise en production.
La fenêtre pop-up est bloquée
Les navigateurs n’autorisent l’ouverture d’une fenêtre que lors d’une action de l’utilisateur. Appelez book() de manière synchrone dans le gestionnaire de clic, et non après un await, un fetch ou un setTimeout. Voir Modes de paiement.
Le panneau s’ouvre vide
L’iframe de paiement a été bloquée. Autorisez https://www.entase.com dans la directive frame-src de votre politique de sécurité du contenu – voir Installation du client.
« Entase n’est pas défini »
Le script n’avait pas fini de se charger lorsque votre code s’est exécuté. Cela se produit lorsque client.js est chargé avec async ou defer, ou est placé après le script qui l’utilise. Attendez l’événement entase:ready – voir Installation du client.
« Tentative de réservation d’un événement après la destruction du client »
destroy() a été appelé sur l’instance et celle-ci ne peut plus être utilisée. Dans une application monopage, cela signifie généralement qu’un composant a détruit son client alors qu’une référence partagée est restée en place. Créez une nouvelle instance pour la nouvelle vue.
« Échec de l’initialisation de l’iframe Entase. Conteneur introuvable. »
Widget intégré uniquement. Le code obj de la configuration ne correspond à aucun élément de la page. L’id du conteneur doit être entase_ suivi du même code, et il doit exister dans le DOM avant l’initialisation du widget – vérifiez s’il y a une faute de frappe ou si un conteneur est rendu plus tard par vos propres scripts.
Seul le dernier écouteur d’événement s’exécute
on() conserve un rappel par nom d’événement, et l’enregistrement d’un second remplace le premier. Enregistrez-en un seul et répartissez les traitements depuis ce rappel – voir Événements.
La fenêtre pop-up s’ouvre sur le mauvais écran
Le point central est calculé lors de la création de l’instance et n’est pas mis à jour lorsque le visiteur déplace la fenêtre du navigateur. Recalculez-le avant la réservation avec setTopWindowCenter() – voir Référence des méthodes.
Les paramètres de suivi sont absents des commandes
Le client autonome ne lit pas l’URL de votre page. Transmettez vous-même les paramètres à tprm – voir Suivi et consentement. Notez que setTracking() remplace l’objet entier au lieu de le fusionner, de sorte qu’un appel ultérieur peut supprimer silencieusement des paramètres précédents.