Le client JavaScript Entase est une petite bibliothèque que vous chargez depuis notre CDN. Il donne à votre site web une capacité qu’il ne peut pas assurer seul : ouvrir le paiement Entase directement sur place, afin qu’un visiteur puisse acheter un billet sans quitter la page qu’il consulte.
Il gère le volet ou la fenêtre pop-up, l’arrière-plan, le verrouillage du défilement de la page, l’étape de consentement, les paramètres régionaux et les paramètres de suivi. Votre code décide quand ouvrir le paiement et pour quel événement.
Ce qu’il n’est pas
Le client n’affiche pas les listes d’événements, les dates, les prix ou les disponibilités. Si vous souhaitez un widget prêt à l’emploi qui présente votre programme, utilisez plutôt les codes d’intégration – ils sont à copier-coller et ne nécessitent aucun travail de développement. Consultez Intégrer des événements sur votre site web.
Les deux ne sont toutefois pas des alternatives. Le widget intégré charge ce même client en arrière-plan pour ouvrir son paiement, c’est pourquoi vous pouvez transmettre des options du client via la configuration de l’intégration. Consultez Options avancées d’intégration.
Quand l’utiliser
Utilisez directement le client lorsque vous avez vos propres pages d’événements et souhaitez que votre propre bouton « Acheter des billets » ouvre le paiement Entase :
<button id="buy">Buy tickets</button>
<script src="https://js.entase.com/client.js"></script>
<script>
const entase = new Entase({ pk: 'YOUR_PUBLISHABLE_KEY' });
document.getElementById('buy').addEventListener('click', () => {
entase.book('EVENT_ID');
});
</script>C’est toute l’intégration. Tout le reste de cette section concerne les ajustements : les options disponibles, la manière dont le paiement choisit entre un volet et une fenêtre pop-up, et les événements que vous pouvez écouter.
Deux modes de paiement
Le paiement s’ouvre de l’une des deux façons suivantes :
- Volet – un panneau intégré à votre page, qui glisse depuis la droite sur ordinateur et depuis le bas sur mobile. Le visiteur ne quitte jamais votre site.
- Pop-up – une fenêtre distincte du navigateur.
Le mode volet offre une meilleure expérience, mais il est uniquement disponible pour les domaines que vous avez ajoutés comme origines approuvées dans vos paramètres Entase. Le client détecte le mode qu’il est autorisé à utiliser et bascule vers une fenêtre pop-up lorsque le paiement intégré n’est pas autorisé. C’est le comportement le plus important à comprendre avant l’intégration – consultez Modes de paiement.
Prérequis
- Une page servie via HTTPS. En HTTP simple, le client utilise toujours une fenêtre pop-up.
- Votre domaine ajouté aux origines approuvées dans Paramètres → Intégrations, si vous souhaitez utiliser le paiement intégré. Consultez Intégrations et personnalisation du paiement.
- Aucune étape de build, aucun bundler ni gestionnaire de paquets. La bibliothèque se compose d’une seule balise de script.
Étapes suivantes
- Installer le client – charger le script et créer une instance.
- Options du constructeur – chaque option et sa valeur par défaut.
- Ouvrir le paiement – la méthode
book()et les remplacements par appel. - Événements – réagir à l’ouverture, à la fermeture et à la finalisation du paiement.