Contexte
Le widget ProAbono est une application autonome et intelligente qu’il suffira d’ajouter dans le code de votre site web.
Il se matérialise par l’apparition d’une vignette qui permet d’ouvrir une interface interactive qui affiche en temps réel les informations liées à l’abonnement du client connecté.
Pourquoi installer le Widget ProAbono ?
- Pour rapidement mettre en place votre business par abonnement.
- Pour permettre la souscription en self service dans votre application
- Pour disposer au plus vite des éléments essentiels de la gestion d’abonnement pour vos utilisateurs.
- Pour ne pas avoir à coder et à recoder cette partie si vous avez une langue, une devise ou ajustez vos offres.
Procédure
Cette installation va affiche un widget à vos utilisateurs connectés afin de pouvoir souscrire à vos offres.
Voici comment installer le widget dans n’importe quelle application web.
1/ Rendez-vous sur la section Intégration.
- Cliquez ici pour accéder à votre section widget dans votre back-office ProAbono
- Sélectionnez votre type d’installation : “Single apps application” ou “Java Script Basique”
- Récupérer le code du widget
2/ Variabiliser les données du widget
Dans ce code, remplacez les variables d’exemple (en rouge) avec les données de votre utilisateur, dans l’object window.proAbonoSettings.
<script>
window.proAbonoSettings = {
business_id: 1067,
segment_ref: "EUR",
customer_ref: "cust-42"
customer_name: "John Doe", // optional
customer_email: "john@doe.com", // optional
customer_lang: "fr", // optional
};
3/ Copiez le code avec les variables dans votre application
Copiez-collez ce code avant la balise <body> dans toutes les pages où le widget doit apparaître.
4/ Sécuriser le Widget (optionnel en sandbox)
Avant de passer en production, vous devez impérativement sécuriser le widget pour éviter l’usurpation d’identité.
Pour ce faire, vous devez générer un hash de sécurité pour l’utilisateur connecté et à ajouter dans l’objet window.proAbonoSettings (voir étape 1).
window.proAbonoSettings = {
...
hash: "29d8b6e5edab22dccac0d60bd3377a2349331e314e752d6bf0731e7c3c22bc29"
};
Comment générer le hash de sécurité ?
Le hash de sécurité pour un client est généré avec l’algorithm HMAC-256, en se basant sur une clé secrète et la référence du client.
Pour plus de détails sur la sécurisation du Widget de ProAbono, connectez-vous sur votre back-office ProAbono et rendez-vous dans la section Intégration.
Cliquer sur Installation > Widget > Widget basique.
Vous trouverez alors un module pour vous aider dans la création du hash de sécurité et un vérificateur pour tester le hash de sécurité.