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..."
}

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.

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é.