Cette liste vous présente tout ce dont vous avez besoin avant de lancer JeriCommerce avec l’intégration API. Ce parcours s’adresse aux équipes qui gèrent les clients et les données de fidélité sur leur propre plateforme et souhaitent synchroniser ces données dans JeriCommerce pour alimenter les passes Wallet, les notifications push et les campagnes.

Choisissez ce parcours si votre fournisseur de fidélité ou votre plateforme existante reste la source des données clients et des points. Dans le processus d’intégration Shopify, l’option destinée aux programmes existants est réservée à LoyaltyLion. Si vous utilisez un autre fournisseur, suivez plutôt cette liste API afin de ne pas créer un deuxième programme de points JeriCommerce.

1. Présentation de votre environnement

Avant de commencer, vérifiez les outils que vous utiliserez :

  • Votre plateforme : le système qui contient vos données clients et de fidélité (CRM, système personnalisé, ERP, etc.)
  • JeriCommerce Wallet (installé depuis le Shopify App Store ou configuré de manière autonome)
  • Un développeur ou une équipe technique en mesure d’envoyer des requêtes HTTP à l’API JeriCommerce

L’intégration API est conçue pour les équipes qui disposent déjà d’un système de fidélité ou d’une base de données clients et souhaitent la connecter aux fonctionnalités Wallet et de notification de JeriCommerce.

2. Générer vos identifiants API

Créer une clé API

  • Dans votre tableau de bord JeriCommerce, accédez à Settings > Technical > API Keys.
  • Cliquez sur Create API Key, donnez un nom à la clé et copiez sa valeur : vous ne pourrez la voir qu’une seule fois.

Fonctionnement de l’authentification API

Trouver le slug de votre programme

  • Accédez à Settings > Technical > Program Information.
  • Copiez votre Program Slug ; il sera utilisé dans toutes les URL des endpoints API.

Toutes les requêtes API sont envoyées à :

https://api.jericommerce.com/v1/programs/{program_slug}/integrations/api

3. Synchroniser vos clients

Envoyez les données de vos clients à JeriCommerce afin que des passes Wallet puissent être générés pour chacun d’eux.

  • Utilisez l’endpoint POST avec feature: "users" pour créer ou mettre à jour des clients.
  • Vous pouvez envoyer jusqu’à 250 clients par requête.
  • Champ obligatoire : email. Champs facultatifs : firstName, lastName, phone, externalCustomerId, emailVerified.

Référence de l’API client

Si vous gérez également les données de fidélité, vous pouvez envoyer les données client et fidélité dans la même requête. Veillez simplement à placer les données du client avant celles de fidélité.

4. Synchroniser les données de fidélité

Si votre plateforme suit les points, les niveaux ou le statut d’adhésion, synchronisez ces données vers JeriCommerce afin qu’elles apparaissent sur le pass Wallet.

  • Utilisez l’endpoint POST avec feature: "loyalty" pour envoyer le solde, le statut de niveau et la date d’adhésion.
  • Champs obligatoires : loyaltyCustomerId, balance, memberSince.
  • Champ facultatif : tierStatus (nom du niveau affiché sur le pass Wallet).

Référence de l’API de fidélité

Le client doit exister dans JeriCommerce avant que vous puissiez ajouter ses données de fidélité. Si vous synchronisez les deux dans une seule requête, placez les données client avant les données de fidélité.

5. Configurer les webhooks (abonnements aux événements)

Abonnez-vous aux événements JeriCommerce afin que votre plateforme reste synchronisée lorsque des actions se produisent dans Wallet.

  • Accédez à Settings > Integrations > API et saisissez votre Webhook URL.
  • JeriCommerce enverra à votre URL des requêtes HTTP POST pour les 19 événements.
  • Chaque requête comprend une signature HMAC-SHA256 dans l’en-tête x-jericommerce-hmac-sha256 à des fins de vérification.

Vous recevrez notamment les événements suivants : installation ou désinstallation d’un pass Wallet, changement de solde, changement de niveau, utilisation d’une récompense, scan d’un client au POS, etc.

Référence complète des événements

6. Design et configuration du pass Wallet

Personnaliser votre carte de fidélité

  • Ouvrez Customize → Loyalty card, puis choisissez Apple ou Google.
  • Sous Card, personnalisez les visuels et les couleurs de votre marque. Ouvrez Details pour modifier les sections au verso du pass.

Configurez des sections et des liens au verso de la carte Wallet pour accéder rapidement aux éléments suivants :

  • Votre site web ou votre portail client
  • Les pages de récompenses, de compte ou de portail client
  • Les pages produit ou les pages de destination

Générez des liens de téléchargement pour permettre à vos clients d’installer leur pass Wallet.

  • Utilisez l’API Customer Tokens pour générer un jeton download par client.
  • Format de l’URL de téléchargement : https://jeri.link/{slug}/download?token={base64Token}.
  • Vous pouvez également générer des jetons auth pour accéder directement à l’application client (récompenses, profil, etc.).

Options de distribution :

  • Intégrez les liens de téléchargement à vos e-mails ou SMS.
  • Ajoutez-les à vos pages de compte, de profil ou d’application web.
  • Incluez-les dans vos flux après achat.

8. Configuration détaillée de la vitrine et des comptes Shopify

Si vous utilisez Shopify avec une intégration API personnalisée, des emplacements spécifiques pour la vitrine et le compte sont généralement plus adaptés qu’un hub par défaut unique. Utilisez les points de contact correspondant au parcours client que vous gérez déjà :

9. Campagnes et notifications

Une fois les passes Wallet installés par les clients, vous pouvez les mobiliser avec des notifications push :

Notifications push

  • Annoncez les soldes, les nouveautés ou les offres à durée limitée.

Comment fonctionnent les notifications push

Campagnes géolocalisées

  • Déclenchez une notification push lorsque les clients se trouvent à proximité d’un magasin.

Comment fonctionnent les notifications géolocalisées

10. Omnicanal : Shopify POS

Si vous avez des magasins utilisant Shopify POS :

Votre intégration API JeriCommerce est configurée et prête à être lancée !