> 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/ticketing/aparte/setup.md).

# Configuration

Connectez Aparté à The Wallet Crew et validez la configuration principale.

### Pourquoi cette configuration est importante

La configuration relie The Wallet Crew à l’API Aparté WalletCrew. Une fois configuré, Aparté reste la source de vérité pour les données des billets, tandis que The Wallet Crew gère la création et les mises à jour des cartes Wallet.

L’objectif est de rendre la livraison des billets fiable dès le premier jour. Une configuration correcte évite aussi les décalages d’heure, de siège ou d’événement sur la Carte.

<details>

<summary><strong>Exemples réels</strong></summary>

* **Déploiement par lieu**: connectez une API de lieu et émettez des billets Wallet à partir du flux de vente existant.
* **Lancement pilote**: commencez avec un seul modèle d’événement, puis étendez-vous à d’autres événements après validation.
* **Validation opérationnelle**: vérifiez que l’heure de l’événement, le siège et le code-barres s’affichent correctement avant la mise en production.

</details>

### Disponibilité du connecteur

{% hint style="info" %}
Le connecteur Aparté doit être activé par The Wallet Crew avant le début de la configuration.
{% endhint %}

Aucun paramètre du connecteur ne peut être enregistré avant cette activation.

### Prérequis

Préparez ces valeurs avant le début de la configuration :

* **URL de base** de l’API Aparté WalletCrew
* **Locataire** identifiant
* **Clé API**

Conservez tous les identifiants spécifiques à l’environnement. La préproduction et la production doivent utiliser des secrets différents.

### Configuration en 2 étapes

La configuration est généralement rapide. La plupart des projets n’ont besoin que d’un connecteur, d’un modèle par défaut et d’un billet de validation.

{% stepper %}
{% step %}

#### Renseignez les paramètres du connecteur

Ouvrir **Connecteurs → Aparté** et saisissez les détails de connexion recueillis auprès d’Aparté.

<figure><img src="https://3852727835-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FlP7d71aYydav6e0pRkxc%2Fuploads%2FZZijvjENIjiiirJ6R8ch%2Fimage.png?alt=media&#x26;token=ee628e02-aba9-4049-8176-f44a56fdbf15" alt="Aparté connector configuration screen in The Wallet Crew admin, showing the API connection fields and default pass type settings."><figcaption><p>Cet écran indique où saisir les identifiants de l’API Aparté et définir le comportement par défaut de la Carte.</p></figcaption></figure>

Puis définissez ces options du connecteur :

* **Type de Carte par défaut**
* **Type de Carte invalide**

Le **Type de Carte par défaut** est le modèle de repli. Il peut encore être remplacé dans [Personnalisation avancée](/connectors/fr/ticketing/aparte/advanced-customization.md).
{% endstep %}

{% step %}

### Partager la clé d’API The Wallet Crew à Aparté

Partager **La clé API The Wallet Crew** avec Aparté lorsque Aparté doit rappeler The Wallet Crew.

<figure><img src="https://3852727835-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FlP7d71aYydav6e0pRkxc%2Fuploads%2F6vzcPWf1uMvn1kYZfHTh%2Fimage.png?alt=media&#x26;token=76e1f62c-7561-43c3-be24-a0a72a6bb2af" alt="The Wallet Crew API key details screen used to copy the key that Aparté needs for callback access."><figcaption><p>Partagez cette clé API avec Aparté lorsque l’accès de rappel à The Wallet Crew est requis.</p></figcaption></figure>
{% endstep %}
{% endstepper %}

### Tester la configuration

Définir le modèle Wallet **Fournisseur de billets** sur `aparte.ticket`.

Puis testez avec un vrai billet et confirmez :

* la Carte s’ouvre correctement
* l’heure de l’événement est correcte
* le siège et le code-barres correspondent au billet source

Si l’heure de l’événement est incorrecte, vérifiez d’abord le fuseau horaire par défaut configuré.

### Ce que fait chaque paramètre

Seuls deux paramètres du connecteur comptent pour une première configuration.

* **Type de Carte par défaut** — modèle Wallet de repli pour les billets valides
* **Type de Carte invalide** — modèle utilisé lorsqu’un billet ne peut plus être résolu

**Paramètres avancés**

Ces paramètres peuvent être ajoutés en cas de besoin :

* **Fuseau horaire par défaut du lieu** — fuseau horaire de repli utilisé pour afficher l’heure locale de l’événement
* **Limitation de débit par défaut** — limite de protection de l’API, définie à **500 requêtes/min** par défaut

<figure><img src="https://3852727835-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FlP7d71aYydav6e0pRkxc%2Fuploads%2FAwM3fUTAcJe0Fi14zus8%2Fimage.png?alt=media&#x26;token=46f45d03-270a-4cc5-8c7d-27a0a4ee0340" alt="Advanced connector settings showing the default venue timezone and default rate limiting fields."><figcaption><p>Ces paramètres facultatifs contrôlent le fuseau horaire de repli et la limite de requêtes API par défaut.</p></figcaption></figure>

Cela suffit pour un premier déploiement. Le routage avancé pourra venir plus tard si nécessaire.

### FAQ

<details>

<summary><strong>Quel accès à Aparté est requis ?</strong></summary>

Le connecteur utilise l’API Aparté WalletCrew. Les entrées requises sont généralement une URL de base, un identifiant de locataire et une clé API.

</details>

<details>

<summary><strong>Quand faut-il contacter l'assistance The Wallet Crew ?</strong></summary>

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

</details>

<details>

<summary><strong>Pourquoi la configuration du fuseau horaire est-elle importante ?</strong></summary>

Les sessions d’événement Aparté sont liées à l’heure locale du lieu. Un mauvais fuseau horaire peut afficher la mauvaise heure de l’événement sur la Carte Wallet.

</details>

<details>

<summary><strong>Un modèle de Carte spécifique est-il requis ?</strong></summary>

Un modèle Wallet est requis, et il doit utiliser le fournisseur de billets Aparté afin que les champs de billet mappés deviennent disponibles.

</details>

<details>

<summary><strong>Le type de Carte par défaut peut-il être remplacé ?</strong></summary>

Oui.

Le connecteur utilise le type de Carte par défaut configuré comme solution de repli, mais la personnalisation avancée peut encore orienter certains billets vers un autre modèle.

</details>

<details>

<summary><strong>Quelle limitation de débit est utilisée par défaut ?</strong></summary>

La limite de débit par défaut du connecteur est **500 requêtes par minute**.

Cette valeur peut être abaissée ou ajustée lorsque l’environnement Aparté applique une politique de quota différente.

</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 by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://docs.thewalletcrew.io/connectors/fr/ticketing/aparte/setup.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

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.
