JeriCommerce vous permet de générer des jetons pour créer deux types de liens destinés à vos clients : des liens de téléchargement de leur carte de fidélité (Apple Wallet / Google Wallet) et des liens de session qui les connectent directement à la Customer App.
Ces liens sont parfaits pour vos campagnes par e-mail, vos SMS, ou pour les intégrer à votre propre site web ou application.
Prérequis ¶
-
Votre API Key : elle se trouve dans JeriCommerce Admin → Settings → Technical → API Keys.
-
Votre Program ID (ou slug) : visible dans les paramètres de votre programme.
-
L’adresse e-mail du client.
Fonctionnement ¶
-
Appelez l’endpoint Get Customer Token en indiquant l’adresse e-mail du client et le type de jeton souhaité.
-
L’API renvoie un
accessToken. -
Encodez le jeton en Base64 et construisez l’URL à l’aide des formats ci-dessous.
Liens de téléchargement de la carte Wallet ¶
Pour générer un lien permettant au client de télécharger sa carte de fidélité, demandez un jeton avec token_type=download et construisez l’URL suivante :
https://jeri.link/{program-slug}/download?token={base64Token} Lorsque le client ouvre ce lien, une page lui propose de choisir entre Apple Wallet et Google Wallet.
JeriCommerce synchronise déjà automatiquement cette URL de téléchargement via les intégrations. Si vous utilisez Shopify ou Klaviyo, vous n’aurez peut-être pas besoin de générer ce lien manuellement. Consultez Synchroniser l’URL de téléchargement de la carte Wallet avec les profils Shopify, Synchroniser les champs personnalisés avec Shopify et Synchroniser les champs personnalisés avec Klaviyo pour en savoir plus.
Liens de session de la Customer App ¶
Pour générer un lien qui connecte directement le client à une section précise de la Customer App, demandez un jeton avec token_type=auth et construisez l’URL en ajoutant un chemin redirectTo :
https://jeri.link/{program-slug}/{base64Token}?redirectTo={path}
Sections disponibles ¶
| Chemin | Destination |
|---|---|
profile |
Profil du client |
loyalty/rewards |
Récompenses disponibles |
loyalty/earning-flows |
Moyens de gagner des points |
referrals |
Programme de parrainage |
coupons |
Coupons du client |
transactions |
Historique des transactions |
Par exemple, utilisez le chemin loyalty/rewards pour diriger les clients directement vers leur page de récompenses depuis un e-mail promotionnel. |
Récapitulatif des formats d’URL ¶
| Type de lien | Format de l’URL |
|---|---|
| Téléchargement | https://jeri.link/{slug}/download?token={base64Token} |
| Session | https://jeri.link/{slug}/{base64Token}?redirectTo={path} |
Documentation de l’API ¶
Pour consulter la spécification complète de l’endpoint, les paramètres de requête, les exemples de code et la gestion des erreurs, consultez l’endpoint Get Customer Token dans la documentation de l’API JeriCommerce.