> For the complete documentation index, see [llms.txt](https://docs.thewalletcrew.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.thewalletcrew.io/connectors/fr/crm-and-fidelity/comarch/setup.md).

# Configuration

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](/developers-guides/fr/pass-architecture/infrastructure.md#outgoing-ip-addresses) 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

{% hint style="info" %}
Demandez au support The Wallet Crew d’activer le connecteur Comarch sur le tenant avant de commencer la configuration.
{% endhint %}

{% stepper %}
{% step %}

#### Renseigner les paramètres de connexion

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

<figure><img src="/files/a1d5441b3cdfc39719d15083044e900d469c70ec" alt=""><figcaption></figcaption></figure>

Utilisez les valeurs fournies par l’administrateur Comarch.

Les champs principaux sont :

* **URL de base**
* **ID client**
* **secret client**
* **code du programme**
* **code partenaire**
  {% endstep %}

{% step %}

#### Configurer Kafka, si nécessaire

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

<figure><img src="/files/0dfc697f39a7540dbd8ac60da73f42cdf6cd1aa1" alt=""><figcaption></figcaption></figure>

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é.
{% endstep %}

{% step %}

#### 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.
{% endstep %}

{% step %}

#### 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.
{% endstep %}
{% endstepper %}

## Configuration avancée

### Vérifier la limite de limitation

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

<figure><img src="/files/f5bfc2bb52346dd691a49aed0e409bd652eceb41" alt=""><figcaption></figcaption></figure>

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.

<figure><img src="/files/cec88992d7502fdc447867708352e8dec99cee09" alt=""><figcaption></figcaption></figure>

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

<details>

<summary><strong>Quand faut-il contacter le support The Wallet Crew ?</strong></summary>

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

</details>

<details>

<summary><strong>Que faut-il vérifier si l’authentification échoue ?</strong></summary>

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](https://docs.thewalletcrew.io/developers-guides/pass-architecture/infrastructure#outgoing-ip-addresses) page authentifiée.

</details>

<details>

<summary><strong>Quand faut-il <code>Récupérer le solde des transactions client</code> être activé ?</strong></summary>

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.

</details>

<details>

<summary><strong>The Wallet Crew stocke-t-il les données de fidélité Comarch ?</strong></summary>

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.

</details>

<details>

<summary><strong>Kafka est-il nécessaire pour que la configuration fonctionne ?</strong></summary>

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

</details>

<details>

<summary><strong>Comment The Wallet Crew reste-t-il à jour avec les informations Comarch ?</strong></summary>

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](/connectors/fr/crm-and-fidelity/comarch/real-time-updates.md) pour le flux détaillé.

</details>

<details>

<summary><strong>Que faut-il valider en premier ?</strong></summary>

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.

</details>


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://docs.thewalletcrew.io/connectors/fr/crm-and-fidelity/comarch/setup.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.