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, dans Settings > Technical > API keys. Si la clé est restreinte, elle a besoin de l’autorisation Customer tokens. Consultez Authentification via l’API.
-
Le slug ou l’identifiant de votre programme, dans Settings > Technical > Program Information.
-
L’adresse e-mail du client.
Fonctionnement ¶
-
Appelez l’endpoint ci-dessous 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.
Endpoint ¶
GET https://api.jericommerce.com/v1/programs/{program_slug}/customers/token?email={customerEmail}&token_type=download&expires_in=7d
| Paramètre | Obligatoire | Notes |
|---|---|---|
email |
Oui | L’adresse e-mail du client, encodée pour une URL. |
token_type |
Oui | download pour un lien de téléchargement de la carte de fidélité, ou auth pour un lien de session de la Customer App. |
expires_in |
Non | La durée de validité du jeton, en secondes ou sous forme de durée comme 10h, 2 days ou 7d. Sans ce paramètre, le jeton expire au bout de 7 jours. |
Si vous n’envoyez pas expires_in, le jeton expire au bout de 7 jours. D’ici là, toute personne qui possède le lien peut l’utiliser : définissez donc une expiration adaptée à la façon dont vous partagez le lien.
Une requête réussie renvoie 200 :
{
"accessToken": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9..."
}
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}
Le client doit déjà avoir une carte de fidélité pour ce type de jeton.
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} |
Erreurs ¶
| Code | Statut | Signification |
|---|---|---|
CUSTOMER_NOT_REGISTERED |
400 |
Aucun client avec cette adresse e-mail n’existe dans le programme. |
CUSTOMER_HAS_NO_USER_DATA |
412 |
Le client n’a pas encore de données de profil. Créez-les avec le point de terminaison client. |
CUSTOMER_HAS_NO_PASSES_FOR_THIS_PROGRAM |
412 |
auth uniquement. Le client n’a pas encore de carte de fidélité. |