Configuration

Configurez le connecteur Comarch dans The Wallet Crew, connectez les identifiants et validez l’intégration.

La configuration de Comarch commence par la préparation du projet. L’équipe doit s’aligner sur le cas d’usage fidélité, le contenu cible de la carte et le parcours opérationnel avant de renseigner les paramètres du connecteur.

Cette préparation aide à confirmer quelles données Comarch sont nécessaires, comment la carte doit se comporter et comment l’intégration sera validée.

Que collecter avant la configuration

Avant d’ouvrir les paramètres du connecteur, s’aligner sur le périmètre métier de l’intégration.

Cela inclut généralement le type de carte, les données qui doivent y apparaître et le comportement de rafraîchissement attendu après les événements de fidélité.

Les scénarios cibles doivent également être clairs avant le début de la configuration. Les scénarios typiques incluent la création de la carte, le rafraîchissement de la carte après un achat, l’affichage du changement de statut, l’affichage du magasin préféré ou la mise à jour du coupon.

Les cas de test doivent être préparés en même temps. Ils doivent permettre de valider à la fois l’expérience client attendue et les données renvoyées par Comarch pendant la configuration.

Une fois cette préparation terminée, collectez les valeurs techniques ci-dessous :

• URL de base de l’API Comarch CLM B2B Gateway, par exemple https://clm.brand.com/
• ID client et secret client pour l’accès OAuth 2.0
• code du programme pour le programme de fidélité
• code partenaire pour l’unité commerciale
• Vérifiez que les adresses IP sortantes de The Wallet Crew sont autorisées par Comarch. La liste actuelle est disponible dans le Infrastructure page authentifiée.

Si les mises à jour en temps réel doivent être activées, préparez également :

• Serveurs de bootstrap pour le cluster Kafka
• Nom d’utilisateur et préférence de type Mot de passe pour l’authentification Kafka
• Topic utilisés par les événements Comarch CLM

Configurer le connecteur

Demandez au support The Wallet Crew d’activer le connecteur Comarch sur le tenant avant de commencer la configuration.

1

Renseigner les paramètres de connexion

Ouvrez Connecteurs → Comarch et complétez les champs de connexion.

Utilisez les valeurs fournies par l’administrateur Comarch.

Les champs principaux sont :

• URL de base
• ID client
• secret client
• code du programme
• code partenaire

2

Configurer Kafka, si nécessaire

Ouvrez la section Kafka uniquement lorsque Comarch publie des flux d’événements.

Renseignez les champs suivants :

• Serveurs de bootstrap
• Nom d’utilisateur
• préférence de type Mot de passe
• Topic

Si cette section reste vide, le connecteur fonctionne quand même. Les cartes se rafraîchissent alors uniquement à l’ouverture de la carte ou lors du rafraîchissement planifié.

3

Lier les fournisseurs de modèles de carte

Assurez-vous comarch.customer est activé comme fournisseur de données de carte.

Assurez-vous comarch.store est également activé comme fournisseur de données de carte lorsque les données du magasin sont nécessaires sur la carte.

4

Valider la configuration

Testez avec une carte qui contient déjà id.comarch.customerId.

Confirmez ensuite que le rafraîchissement de la carte renvoie les données client. Si storeId est présent, confirmez également les données du magasin.

Configuration avancée

Vérifier la limite de limitation

La limite de limitation par défaut est 80 appels API par seconde.

Cela correspond au quota habituel du tenant Comarch CLM B2B Gateway. Ne modifiez ce paramètre que lorsqu’une autre limite est confirmée.

Récupérer le solde des transactions client

Activer Récupérer le solde des transactions client lorsque la carte a besoin de plus que le solde principal de points.

Cette option effectue un appel API supplémentaire à Comarch pour récupérer le solde détaillé des transactions client, y compris les points en attente et les détails de solde associés.

Utilisez-la uniquement lorsque ces valeurs sont requises sur la carte ou dans le périmètre de validation. Cela augmente le nombre d’appels API Comarch pendant le rafraîchissement.

Checklist de validation

Une configuration valide confirme généralement quatre éléments :

• L’authentification OAuth réussit
• les données client se chargent depuis Comarch
• les données du magasin se chargent lorsque storeId existe
• les champs de la carte affichent les valeurs attendues

FAQ

Quand faut-il contacter le support The Wallet Crew ?

Contactez le support The Wallet Crew avant le début de la configuration afin que le connecteur Comarch puisse être activé sur le tenant.

Que faut-il vérifier si l’authentification échoue ?

Vérifiez le URL de base, ID client, et secret client d’abord.

Confirmez ensuite que le client OAuth peut accéder aux API de profil et de partenaire.

Si les identifiants sont corrects et que l’authentification échoue toujours, vérifiez que les adresses IP sortantes de The Wallet Crew sont autorisées par Comarch. La liste actuelle est disponible dans le Infrastructure page authentifiée.

Quand faut-il Récupérer le solde des transactions client être activé ?

Activez-le lorsque la carte a besoin d’informations détaillées sur le solde, telles que les points en attente. Si la carte n’a besoin que du solde principal de points, ce n’est généralement pas nécessaire.

The Wallet Crew stocke-t-il les données de fidélité Comarch ?

Non. The Wallet Crew lit les données nécessaires depuis Comarch lorsqu’un rafraîchissement de la carte les requiert.

Ce connecteur est conçu pour conserver Comarch comme source de vérité pour les données de fidélité telles que les points, le niveau, le profil ou les informations du magasin.

Kafka est-il nécessaire pour que la configuration fonctionne ?

Non. Kafka est facultatif. Sans lui, le connecteur fonctionne toujours et les cartes peuvent toujours se rafraîchir à l’ouverture de la carte ou lors du rafraîchissement planifié.

Comment The Wallet Crew reste-t-il à jour avec les informations Comarch ?

Kafka aide The Wallet Crew à rester aligné sur les changements Comarch au fur et à mesure qu’ils se produisent.

Lorsque Comarch publie des événements de fidélité dans Kafka, The Wallet Crew peut réagir plus rapidement aux changements tels que les mises à jour de points, les changements de statut ou les mises à jour du magasin. Sans Kafka, le rafraîchissement fonctionne toujours, mais il dépend du timing de l’ouverture de la carte ou du rafraîchissement planifié.

Voir Mises à jour en temps réel pour le flux détaillé.

Que faut-il valider en premier ?

Commencez par la recherche client. Validez ensuite la recherche du magasin lorsque storeId fait partie du scénario. Le rafraîchissement en temps réel peut être validé une fois que le flux de données de base fonctionne.