> 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/configure/fr/advanced-configuration/platform/custom-domain.md).

# Domaine personnalisé

Utilisez un domaine appartenant à la marque pour les pages hébergées The Wallet Crew telles que l'inscription, le téléchargement de Cartes et les parcours Wallet liés au compte.

Un domaine personnalisé aligne les pages hébergées de The Wallet Crew sur l’identité de la marque. Il réduit également le risque d’hameçonnage et renforce la confiance lorsque les clients ouvrent les parcours d’inscription ou de téléchargement de Carte.

Par défaut, The Wallet Crew diffuse les pages hébergées sur son propre domaine, par exemple `https://app.thewalletcrew.io/<tenantId>/<layout>`. Un domaine personnalisé remplace ce point d’entrée public par un domaine appartenant à la marque, tel que `https://wallet.example.com`. Le préfixe `neostore` est l’ancien nom de la plateforme et est conservé dans les identifiants techniques.

## Avant de commencer

Choisissez le domaine public qui hébergera le parcours. Un sous-domaine dédié est recommandé : il évite les conflits avec le site existant et isole le trafic Wallet.

La marque doit également avoir accès à sa zone DNS, ainsi qu’à un compte de la console d’administration disposant d’un accès à **Paramètres**. Toutes les modifications DNS sont effectuées dans la zone DNS.

{% hint style="info" %}
Cette page traite du domaine web hébergé (l’ **Application** onglet). Le domaine d’expéditeur d’e-mails fait l’objet d’une configuration distincte, dans l’ **Expéditeur d’e-mails** onglet de la même page. Pour la distribution des e-mails, voir [Fournisseur de messagerie](https://docs.thewalletcrew.io/connectors/fr/email-provider.md) et [SendGrid](https://docs.thewalletcrew.io/connectors/fr/email-provider/sendgrid.md).
{% endhint %}

## Fonctionnement de la configuration

Les domaines personnalisés sont gérés en libre-service. Ouvrez **Paramètres → Général → Domaines personnalisés**. La page comporte deux onglets : **Application** pour les pages hébergées décrites ici, et **Expéditeur d’e-mails** pour le domaine d’expéditeur d’e-mails (voir l’indication ci-dessus).

Les pages hébergées sont diffusées via le réseau edge de The Wallet Crew. Vous ajoutez le domaine dans la console d’administration, la console affiche les deux enregistrements DNS à publier, puis vous vérifiez la configuration et mettez en ligne. Une vérification réussie ne bascule jamais les clients vers le domaine d’elle-même : tant que vous ne cliquez pas sur **Mettre en ligne**, les clients continuent d’utiliser l’adresse standard.

Règles :

* Un tenant peut avoir un domaine personnalisé.
* Les domaines génériques sont refusés.
* Un domaine racine (apex) nécessite un aplatissement CNAME, ou un enregistrement ALIAS ou ANAME, chez le fournisseur DNS. Un sous-domaine dédié permet d’éviter cela.

{% hint style="info" %}
Les domaines personnalisés ne sont pas proposés dans tous les environnements. Si la page indique "Les domaines personnalisés ne sont pas disponibles dans cet environnement", la fonctionnalité n’y est pas activée. Ne réessayez pas.
{% endhint %}

## Configurer le domaine personnalisé

{% stepper %}
{% step %}

### Sélectionnez le domaine public

Choisissez le sous-domaine qui sera exposé aux clients, par exemple `wallet.example.com`, `registration.example.com` ou `tickets.example.com`.
{% endstep %}

{% step %}

### Ajoutez le domaine dans la console d’administration

Ouvrez **Paramètres → Général → Domaines personnalisés → Application** puis cliquez sur **Ajouter un domaine**. Saisissez le domaine choisi dans **Domaine**, puis cliquez sur **Ajouter le domaine**. La console vérifie d’abord que le domaine peut être utilisé, puis affiche les deux enregistrements DNS à publier.

Les noms et valeurs exacts dépendent du tenant. Ne les devinez pas et ne les réutilisez pas depuis un autre tenant ou environnement.
{% endstep %}

{% step %}

### Publiez les enregistrements DNS

Ajoutez les deux enregistrements exactement comme indiqué dans la console, dans la zone DNS de la marque :

* un enregistrement CNAME qui redirige le domaine vers les pages hébergées
* un enregistrement TXT (`asuid.`) qui prouve la propriété du domaine
  {% endstep %}

{% step %}

### Vérifiez la configuration

Une fois les enregistrements visibles dans le DNS, cliquez sur **Vérifier la configuration** sur la même page. La console indique ce qui ne va pas lorsque la vérification échoue, par exemple un enregistrement CNAME manquant ou un enregistrement CNAME défini sur "DNS only" chez le fournisseur.

The Wallet Crew émet alors le certificat, généralement en moins de deux minutes. Le domaine est alors **Prêt**. Tester trop tôt peut produire de faux négatifs pendant que le DNS se propage encore.
{% endstep %}

{% step %}

### Testez, puis mettez en ligne

Lorsque l’état est **Prêt**, le domaine répond déjà avec un certificat valide, mais les clients sont toujours redirigés vers l’adresse standard. Ouvrez l’URL finale et validez l’intégralité du parcours :

* la page se résout sur le domaine personnalisé
* HTTPS est valide
* la mise en page prévue se charge correctement
* les flux d’inscription, de connexion ou de téléchargement de Carte fonctionnent toujours comme prévu
* les équipes internes utilisent le domaine personnalisé dans les campagnes, les codes QR et les scripts de support

Puis cliquez sur **Mettre en ligne**. À partir de ce moment, les nouveaux e-mails, codes QR et liens d’inscription utilisent le domaine personnalisé.

Puis passez en revue les systèmes répertoriés dans [Autres éléments à mettre à jour](#faq).
{% endstep %}
{% endstepper %}

{% hint style="warning" %}
**Supprimer le domaine** sur un domaine en production renvoie les clients vers l’adresse standard, et les liens qui utilisent déjà le domaine personnalisé cessent de fonctionner.
{% endhint %}

## États du domaine

La console d’administration affiche l’un de ces états :

| État                       | Signification                                                                                                                                                               |
| -------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **En attente de DNS**      | Le domaine est ajouté. Ajoutez les deux enregistrements chez votre fournisseur DNS. Rien ne change pour les clients tant que vous n’avez pas mis en ligne.                  |
| **Émission du certificat** | Les enregistrements fonctionnent. Le certificat est en cours d’émission, ce qui prend généralement moins de deux minutes.                                                   |
| **Prêt**                   | Le domaine répond avec un certificat valide. Les clients sont toujours redirigés vers l’adresse standard jusqu’à ce que vous cliquiez sur **Mettre en ligne**.              |
| **En ligne**               | Le domaine sert vos clients. Le certificat se renouvelle automatiquement : laissez les enregistrements DNS en place.                                                        |
| **Ne fonctionne pas**      | Le domaine n’a pas pu être validé dans les 24 heures, ou le fournisseur l’a refusé. Vérifiez les enregistrements, puis cliquez sur **Vérifier la configuration** à nouveau. |
| **Supprimé**               | Le domaine n’est plus enregistré auprès du fournisseur. Supprimez-le puis ajoutez-le à nouveau pour recommencer.                                                            |

## Exemples d’enregistrements DNS

Les valeurs exactes varient selon le tenant et l’environnement. L’exemple ci-dessous est anonymisé. La console d’administration est la source de vérité pour les enregistrements à publier.

| Type  | Nom d’hôte                     | Valeur                                                            | Objectif                                           |
| ----- | ------------------------------ | ----------------------------------------------------------------- | -------------------------------------------------- |
| CNAME | registration.example.com       | valeur affichée dans la console, par exemple `app.neostore.cloud` | Redirige le trafic client vers les pages hébergées |
| TXT   | asuid.registration.example.com | `<valeur affichée dans la console>`                               | Validation de la propriété du domaine              |

## FAQ

<details>

<summary><strong>Un domaine personnalisé doit-il être un sous-domaine ?</strong></summary>

Non, mais un sous-domaine dédié est recommandé : il évite les conflits avec le site existant et isole le trafic Wallet. Un domaine racine (apex) nécessite un aplatissement CNAME, ou un enregistrement ALIAS ou ANAME, chez le fournisseur DNS.

</details>

<details>

<summary><strong>La marque doit-elle fournir son propre certificat SSL ?</strong></summary>

Non.

La marque gère les enregistrements DNS. The Wallet Crew gère le cycle de vie du certificat hébergé une fois la validation du domaine réussie.

</details>

<details>

<summary><strong>La marque peut-elle placer son propre proxy ou CDN devant le domaine personnalisé ?</strong></summary>

Oui.

La marque peut conserver ses propres règles de sécurité, de routage et de trafic CDN ou proxy devant les pages hébergées de The Wallet Crew, en plus des contrôles de sécurité déjà gérés par The Wallet Crew.

</details>

<details>

<summary><strong>Le même domaine peut-il aussi être utilisé pour l’envoi d’e-mails ?</strong></summary>

Le même espace de noms de marque peut être réutilisé, mais l’hébergement web et l’envoi d’e-mails sont des configurations distinctes.

Par exemple, une marque peut utiliser `registration.example.com` pour les pages hébergées et `no-reply@registration.example.com` pour les e-mails transactionnels. Les enregistrements DNS et le processus de validation restent différents.

</details>

<details>

<summary><strong>Combien de temps prend la configuration ?</strong></summary>

Le délai dépend surtout de la propagation DNS et de la rapidité avec laquelle les enregistrements sont ajoutés. Une fois les enregistrements fonctionnels, le certificat est généralement émis en moins de deux minutes.

</details>

<details>

<summary><strong>Que faut-il d’autre mettre à jour après le passage à un domaine personnalisé ?</strong></summary>

Tout système qui valide l’origine publique doit être examiné.

Parmi les exemples courants figurent les fournisseurs de connexion sociale, les listes d’autorisation de redirection, les campagnes de codes QR, les modèles d’e-mails et la documentation de support qui mentionne encore le domaine par défaut de The Wallet Crew.

</details>

<details>

<summary><strong>Que se passe-t-il si le sous-domaine sélectionné pointe déjà ailleurs ?</strong></summary>

Ce sous-domaine ne peut pas pointer vers deux cibles différentes en même temps.

S’il est déjà utilisé par un autre service, déplacez d’abord ce service ou choisissez un autre sous-domaine dédié pour The Wallet Crew.

</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/configure/fr/advanced-configuration/platform/custom-domain.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.
