# Utiliser votre domaine personnalisé Découvrez comment utiliser votre propre domaine personnalisé avec Stripe Checkout, Payment Links et le portail client. # Page hébergée par Stripe > This is a Page hébergée par Stripe for when payment-ui is stripe-hosted. View the full page at https://docs.stripe.com/payments/checkout/custom-domains?payment-ui=stripe-hosted. Si vous utilisez la [page hébergée par Stripe](https://docs.stripe.com/payments/accept-a-payment.md?payment-ui=checkout&ui=stripe-hosted) pour le paiement, vous pouvez ajouter votre propre domaine personnalisé à Stripe. L’ajout de domaines personnalisés est une fonctionnalité payante. Pour en savoir plus sur le coût, consultez la page [Tarifs](https://stripe.com/pricing) de Checkout. ## Ajouter votre domaine personnalisé au Dashboard Stripe Décidez du sous-domaine à utiliser avec vos sessions Checkout, Payment Links et avec le portail client. > Si votre domaine est `example.com`, nous vous recommandons d’utiliser `payments.example.com` comme sous-domaine personnalisé. Vous pouvez remplacer `payments` par la valeur de votre choix, à condition qu’il s’agisse d’un sous-domaine valide. Vous ne pouvez pas utiliser un chemin comme `example.com/checkout`. Vous devez spécifier un sous-domaine de votre domaine existant. Lorsque vous avez choisi le sous-domaine que vous souhaitez utiliser, accédez à la [page des paramètres de vos domaines personnalisés](https://dashboard.stripe.com/settings/custom-domains) pour procéder à la connexion de votre domaine. Sur la page des paramètres, cliquez sur **Ajouter votre domaine**. Dans la fenêtre contextuelle, saisissez le sous-domaine de votre choix. Cliquez sur **Ajouter** lorsque vous avez terminé. La fenêtre contextuelle s’actualise et affiche les instructions à suivre pour configurer vos enregistrements DNS. Votre domaine personnalisé est activé automatiquement dès lors que vos enregistrements DNS ont été vérifiés. Si vous souhaitez désactiver ce comportement, décochez la case **Activer ce domaine dès son ajout**. > #### Quand mon domaine sera-t-il ajouté ? > > Lorsque votre domaine est à l’état `Adding...`, cela signifie que les enregistrements DNS que vous allez créer à l’étape suivante sont en attente de vérification. Une fois que Stripe a vérifié vos enregistrements, nous créons des certificats TLS pour votre sous-domaine et configurons le routage CDN adéquat. Votre domaine passe alors à l’état `ready` et est prêt à l’emploi. ## Identifier votre fournisseur DNS Commencez par déterminer quel service gère vos enregistrements DNS afin de savoir avec précision où vous connecter et créer les nouveaux enregistrements. Si vous **connaissez déjà** votre fournisseur DNS, vous pouvez passer à la section suivante. En règle générale, votre fournisseur DNS est identique à votre registraire de nom de domaine, mais ce n’est pas toujours le cas. Si vous n’êtes pas certain de connaître votre fournisseur DNS, essayez de rechercher vos serveurs de noms. Pour ce faire, exécutez la commande suivante en remplaçant **stripe.com** par le nom de votre domaine : ```bash nslookup -querytype=NS stripe.com ``` Le terminal renvoie une liste des serveurs de noms pour votre domaine. Voici un exemple de résultat pour **stripe.com** : ``` # Looks like AWS is providing our DNS here: stripe.com nameserver = ns-423.awsdns-52.com. stripe.com nameserver = ns-705.awsdns-24.net. stripe.com nameserver = ns-1087.awsdns-07.org. stripe.com nameserver = ns-1882.awsdns-43.co.uk. ``` Si vous préférez utiliser un outil en ligne, accédez à l’[outil DNS Lookup de MXLookup](https://mxtoolbox.com/DnsLookup.aspx) et saisissez le nom de votre domaine. Cette méthode peut vous permettre de déterminer qui est votre fournisseur DNS (mais elle ne fonctionne pas à tous les coups). ## Créer les enregistrements DNS requis Dans cette section, vous allez créer les enregistrements DNS nécessaires à la connexion de votre domaine. Chaque fois que vous terminez une étape, cochez la case prévue à cet effet pour savoir où vous en êtes. Parmi les onglets ci-après, sélectionnez celui correspondant à votre fournisseur DNS. Vous y trouverez des instructions spécifiques relatives à la création des enregistrements DNS. Si vous ne voyez pas votre fournisseur DNS dans la liste proposée, suivez les instructions standard : #### Instructions standard Voici les instructions standard relatives à la création de vos enregistrements DNS. Si vous rencontrez des difficultés, quelle que soit l’étape à laquelle vous êtes rendu, contactez votre fournisseur DNS pour obtenir de l’aide. > Réalisez les étapes une à une et cochez-les lorsque vous avez terminé pour savoir où vous en êtes rendu. - [ ] Vous connecter à votre fournisseur DNS La plupart des fournisseurs DNS proposent un panneau de contrôle auquel vous pouvez vous connecter pour gérer vos DNS. Accédez à la page du panneau de contrôle de votre fournisseur et connectez-vous. - [ ] Trouver la page de gestion du serveur DNS de votre domaine Maintenant que vous êtes connecté, cherchez où vous pouvez gérer les enregistrements DNS de votre domaine depuis le panneau de contrôle de votre fournisseur. Si vous ne parvenez pas à trouver la bonne page, vous pouvez : - Vérifiez si votre fournisseur DNS n’a pas mis à votre disposition un article d’assistance sur lequel vous pourriez vous appuyer pour ajouter de nouveaux enregistrements DNS. - Pour obtenir de l’aide supplémentaire, contactez votre fournisseur DNS. - [ ] Créer votre enregistrement CNAME Depuis le panneau de contrôle de votre DNS, ajoutez un nouvel enregistrement qui mappe le sous-domaine de votre choix vers Checkout. Lorsque vous créez un nouvel enregistrement, la majorité des fournisseurs DNS vous demandent de préciser type, le nom, la valeur, ainsi que le TTL/délai d’expiration de l’enregistrement. > Cet enregistrement connecte votre sous-domaine à Stripe Checkout. Saisissez ces valeurs et enregistrez le nouvel enregistrement DNS : | Champ | Instructions | Description | | -------------------------- | ----------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | | **Type** | Sélectionnez `CNAME` dans la liste déroulante. | Type de l’enregistrement DNS. | | **Nom** | Si votre sous-domaine personnalisé est **checkout.powdur.me**, saisissez `checkout` | Pour les enregistrements CNAME, ce champ est identique à la première partie de votre sous-domaine (située avant le premier point). | | **Valeur** | Entrez `hosted-checkout.stripecdn.com`. | Destination vers laquelle pointe le nouvel enregistrement du sous-domaine (ici, Stripe). Certains fournisseurs peuvent demander d’inclure un point (`.`) après la valeur CNAME. Vérifiez que le format de votre valeur CNAME correspond aux attentes de votre fournisseur. | | **TTL/délai d’expiration** | Saisissez `300` | Un délai d’expiration de 5 minutes (300 secondes) est acceptable. Il est possible que votre fournisseur ne vous autorise pas à modifier la valeur TTL. Si vous ne voyez pas le champ ou que vous ne pouvez pas le modifier, vous pouvez ignorer cette étape de la configuration. | - [ ] Créer votre enregistrement TXT Depuis le panneau de contrôle de votre fournisseur DNS, ajoutez un nouvel enregistrement TXT. > Cet enregistrement TXT nous permet de vérifier que vous êtes bien le propriétaire de ce domaine. Nous en avons besoin pour délivrer des certificats TLS pour votre domaine, afin que vous puissiez continuer à accepter des paiements en toute sécurité. Saisissez ces valeurs et enregistrez le nouvel enregistrement DNS : | Champ | Instructions | Description | | -------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | | **Type** | Sélectionnez `TXT` dans la liste déroulante. | Type de l’enregistrement DNS. | | **Nom** | Si votre domaine personnalisé est **checkout.powdur.me**, saisissez `_acme-challenge.checkout` | Pour les enregistrements TXT, ce champ est identique à la partie de votre domaine correspondant à votre sous-domaine. | | **Valeur** | Accédez aux [paramètres du Dashboard](https://dashboard.stripe.com/settings/custom-domains), puis cliquez sur **Afficher les instructions** pour copier le bon enregistrement de valeur TXT. | Il s’agit d’une longue chaîne unique utilisée à des fins de vérification du domaine. | | **TTL/délai d’expiration** | Saisissez `300` | Un délai d’expiration de 5 minutes (300 secondes) est acceptable. Il est possible que votre fournisseur ne vous autorise pas à modifier la valeur TTL. Si vous ne voyez pas le champ ou que vous ne pouvez pas le modifier, vous pouvez ignorer cette étape de la configuration. | - [ ] Vérifier que votre enregistrement CNAME est correctement configuré Une fois que vous avez sauvegardé votre enregistrement DNS, vérifiez que les valeurs sont correctes. #### Procéder à la vérification depuis votre terminal 1. Patientez jusqu’à 10 minutes le temps que votre fournisseur DNS mette à jour ses serveurs de noms. 1. Exécutez la commande suivante sur votre terminal en remplaçant **checkout.powdur.me** par votre domaine personnalisé : ```bash nslookup -querytype=CNAME checkout.powdur.me ``` Vous devriez obtenir le résultat suivant : ``` canonical name = hosted-checkout.stripecdn.com. ``` Lorsque vous obtenez ce résultat, passez à l’étape suivante. #### Procéder à la vérification depuis votre navigateur Web 1. Patientez jusqu’à 10 minutes le temps que votre fournisseur DNS mette à jour ses serveurs de noms. 1. Ouvrez l’outil [NSLookup Online Tool](https://coding.tools/nslookup). 1. Saisissez votre nom de domaine personnalisé dans le champ **Domain or IP Address**. 1. Dans la liste déroulante **Query Type**, sélectionnez **CNAME (Canonical name record)**. 1. Cliquez sur **Nslookup** pour rechercher votre enregistrement CNAME. Le résultat doit afficher `canonical name = hosted-checkout.stripecdn.com` (le cas échéant, passez à l’étape suivante). Sinon, patientez quelques instants et exécutez à nouveau la requête. - [ ] Vérifier votre enregistrement TXT Une fois que vous avez sauvegardé votre enregistrement DNS, vérifiez que les valeurs sont correctes. #### Procéder à la vérification depuis votre terminal 1. Patientez jusqu’à 10 minutes le temps que votre fournisseur DNS mette à jour ses serveurs de noms. 1. Exécutez la commande suivante sur votre terminal en remplaçant **checkout.powdur.me** par votre domaine personnalisé : ```bash nslookup -querytype=TXT _acme-challenge.checkout.powdur.me ``` Vous devriez obtenir le résultat suivant : ``` _acme-challenge. text = "" ``` Si le résultat n’affiche pas la valeur unique de votre enregistrement TXT, patientez quelques instants et exécutez à nouveau la commande. #### Procéder à la vérification depuis votre navigateur Web 1. Patientez jusqu’à 10 minutes le temps que votre fournisseur DNS mette à jour ses serveurs de noms. 1. Ouvrez l’outil [NSLookup Online Tool](https://coding.tools/nslookup). 1. Saisissez `_acme-challenge.[your custom domain name]` dans le champ **Domain or IP Address**. 1. Dans la liste déroulante **Query Type**, sélectionnez **TXT (Text record)**. 1. Cliquez sur **Nslookup** pour rechercher votre enregistrement CNAME. Le résultat doit afficher la valeur de l’enregistrement TXT que vous avez saisie à l’étape précédente. Dans le cas contraire, patientez quelques instants et exécutez à nouveau la requête. Une fois que vous avez complété cette étape, la configuration de vos enregistrements DNS est terminée. #### GoDaddy Suivez ces instructions pour créer vos enregistrements DNS avec GoDaddy. Si vous rencontrez des difficultés, quelle que soit l’étape à laquelle vous êtes rendu, veuillez [contacter le service de support de GoDaddy](https://www.godaddy.com/help/contact-us) pour obtenir de l’aide. > Réalisez les étapes une à une et cochez-les lorsque vous avez terminé pour savoir où vous en êtes rendu. - [ ] Se connecter à GoDaddy Accédez à [GoDaddy](https://sso.godaddy.com/) et connectez-vous au tableau de bord GoDaddy. - [ ] Accéder au panneau DNS de votre domaine Depuis le tableau de bord GoDaddy : 1. Cliquez sur votre domaine depuis la page d’accueil GoDaddy : ![Page d'accueil GoDaddy](https://b.stripecdn.com/docs-statics-srv/assets/home.20b5c1d760ee29489f34bd2da87f72d9.png) 1. Vous devriez à présent vous trouver sur la page d’administration de votre domaine : ![Vue administrateur de GoDaddy](https://b.stripecdn.com/docs-statics-srv/assets/admin.e30f10909b86e9d6ea9452f5fba6d324.png) 1. Cliquez sur **Afficher les paramètres du domaine**. 1. Cliquez sur **Gérer les serveurs DNS**. 1. Vous devriez voir apparaître une page de gestion DNS pour votre domaine : ![Vue de gestion DNS de GoDaddy](https://b.stripecdn.com/docs-statics-srv/assets/dns-management.0ba48fee0b095cfb135eec91f30476d2.png) - [ ] Créer votre enregistrement CNAME Ajoutez un nouvel enregistrement qui mappe le sous-domaine de votre choix vers Stripe Checkout. 1. Dans la section relative aux enregistrements DNS, cliquez sur **Ajouter**. 1. Saisissez ces valeurs dans le formulaire qui s’affiche à l’écran : | Champ | Valeur à saisir | Description | | ---------- | ----------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------- | | **Type** | Sélectionnez `CNAME` dans la liste déroulante. | Type de l’enregistrement DNS. | | **Nom** | Si votre sous-domaine personnalisé est **checkout.powdur.me**, saisissez `checkout` | Pour les enregistrements CNAME, ce champ est identique à la première partie de votre sous-domaine (située avant le premier point). | | **Valeur** | `hosted-checkout.stripecdn.com` | Destination vers laquelle pointe le nouvel enregistrement du sous-domaine (ici, Stripe Checkout). | | **TTL** | Sélectionnez `Personnalisé` dans le menu déroulant et saisissez `600` secondes | Un délai d’expiration de 10 minutes (600 secondes) est acceptable. | ![Apparence du formulaire rempli, pour un exemple de domaine](https://b.stripecdn.com/docs-statics-srv/assets/filled-form-cname.c1208c4e8b931447ecdec0fff817d14b.png) Un exemple de formulaire renseigné pour l’ajout de votre enregistrement CNAME. 1. Cliquez sur **Ajouter un enregistrement**. 1. Vous verrez apparaître une nouvelle ligne de tableau correspondant au nouvel enregistrement DNS, contenant les valeurs suivantes : - **Type** : `CNAME` - **Nom** : `` - **Données** : `hosted-checkout.stripecdn.com` - **TTL** : 600 secondes - [ ] Créer votre enregistrement TXT Depuis la page de gestion DNS, ajoutez un nouvel enregistrement TXT. > Cet enregistrement TXT nous permet de vérifier que vous êtes bien le propriétaire de ce domaine. Nous en avons besoin pour délivrer des certificats TLS pour votre domaine, afin que vous puissiez continuer à accepter des paiements en toute sécurité. 1. Cliquez sur **Ajouter**. 1. Saisissez ces valeurs dans le formulaire qui s’affiche à l’écran : | Champ | Valeur à saisir | Description | | ---------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------- | | **Type** | Sélectionner `TXT` dans la liste déroulante | Type de l’enregistrement DNS. | | **Nom** | Si votre domaine personnalisé est **checkout.powdur.me**, saisissez `_acme-challenge.checkout` | Pour les enregistrements TXT, ce champ est identique à la partie de votre domaine correspondant à votre sous-domaine. | | **Valeur** | Accédez aux [paramètres du Dashboard](https://dashboard.stripe.com/settings/custom-domains), puis cliquez sur **Afficher les instructions** pour copier le bon enregistrement de valeur TXT. | Il s’agit d’une longue chaîne unique utilisée à des fins de vérification du domaine. | | **TTL** | Sélectionnez `Personnalisé` dans le menu déroulant et saisissez `600` secondes | Un délai d’expiration de 10 minutes (600 secondes) est acceptable. | ![Apparence du formulaire rempli, pour un exemple de domaine](https://b.stripecdn.com/docs-statics-srv/assets/filled-form-txt.a717729a495d2aa61a68381155206f37.png) Un exemple de formulaire renseigné pour l’ajout de votre enregistrement TXT. 1. Cliquez sur **Ajouter un enregistrement**. 1. Vous verrez apparaître une nouvelle ligne de tableau correspondant au nouvel enregistrement DNS, contenant les valeurs suivantes : - **Type** : `TXT` - **Nom** : `_acme-challenge.` - **Données** : `` - **TTL** : 600 secondes - [ ] Vérifier que votre enregistrement CNAME est correctement configuré Une fois que vous avez sauvegardé votre enregistrement DNS, vérifiez que les valeurs sont correctes. #### Procéder à la vérification depuis votre terminal 1. Patientez jusqu’à 10 minutes le temps que votre fournisseur DNS mette à jour ses serveurs de noms. 1. Exécutez la commande suivante sur votre terminal en remplaçant **checkout.powdur.me** par votre domaine personnalisé : ```bash nslookup -querytype=CNAME checkout.powdur.me ``` Vous devriez obtenir le résultat suivant : ``` canonical name = hosted-checkout.stripecdn.com. ``` Lorsque vous obtenez ce résultat, passez à l’étape suivante. #### Procéder à la vérification depuis votre navigateur Web 1. Patientez jusqu’à 10 minutes le temps que votre fournisseur DNS mette à jour ses serveurs de noms. 1. Ouvrez l’outil [NSLookup Online Tool](https://coding.tools/nslookup). 1. Saisissez votre nom de domaine personnalisé dans le champ **Domain or IP Address**. 1. Dans la liste déroulante **Query Type**, sélectionnez **CNAME (Canonical name record)**. 1. Cliquez sur **Nslookup** pour rechercher votre enregistrement CNAME. Le résultat doit afficher `canonical name = hosted-checkout.stripecdn.com` (le cas échéant, passez à l’étape suivante). Sinon, patientez quelques instants et exécutez à nouveau la requête. - [ ] Vérifier votre enregistrement TXT Une fois que vous avez sauvegardé votre enregistrement DNS, vérifiez que les valeurs sont correctes. #### Procéder à la vérification depuis votre terminal 1. Patientez jusqu’à 10 minutes le temps que votre fournisseur DNS mette à jour ses serveurs de noms. 1. Exécutez la commande suivante sur votre terminal en remplaçant **checkout.powdur.me** par votre domaine personnalisé : ```bash nslookup -querytype=TXT _acme-challenge.checkout.powdur.me ``` Vous devriez obtenir le résultat suivant : ``` _acme-challenge. text = "" ``` Si le résultat n’affiche pas la valeur unique de votre enregistrement TXT, patientez quelques instants et exécutez à nouveau la commande. #### Procéder à la vérification depuis votre navigateur Web 1. Patientez jusqu’à 10 minutes le temps que votre fournisseur DNS mette à jour ses serveurs de noms. 1. Ouvrez l’outil [NSLookup Online Tool](https://coding.tools/nslookup). 1. Saisissez `_acme-challenge.[your custom domain name]` dans le champ **Domain or IP Address**. 1. Dans la liste déroulante **Query Type**, sélectionnez **TXT (Text record)**. 1. Cliquez sur **Nslookup** pour rechercher votre enregistrement CNAME. Le résultat doit afficher la valeur de l’enregistrement TXT que vous avez saisie à l’étape précédente. Dans le cas contraire, patientez quelques instants et exécutez à nouveau la requête. Une fois que vous avez complété cette étape, la configuration de vos enregistrements DNS est terminée. Pour en savoir plus, consultez les guides officiels de GoDaddy destinés aux développeurs, et notamment le guide consacré à la [gestion des enregistrements DNS](https://www.godaddy.com/help/manage-dns-records-680). #### Cloudflare Suivez ces instructions pour créer vos enregistrements DNS avec Cloudflare. Si vous rencontrez des difficultés, quelle que soit l’étape à laquelle vous êtes rendu, veuillez [contacter l’assistance Cloudflare](https://support.cloudflare.com/) pour obtenir de l’aide. > Réalisez les étapes une à une et cochez-les lorsque vous avez terminé pour savoir où vous en êtes rendu. - [ ] Se connecter à Cloudflare Accédez à [Cloudflare](https://cloudflare.com) et connectez-vous au tableau de bord Cloudflare. - [ ] Accéder au panneau DNS de votre domaine Depuis le tableau de bord Cloudflare : 1. À gauche de l’écran, cliquez sur **Sites Web**. 1. Recherchez votre domaine dans la liste des sites Web. 1. Cliquez sur la ligne de tableau contenant votre nom de domaine : ![Le tableau des sites Web que vous verrez sur le Dashboard Cloudflare](https://b.stripecdn.com/docs-statics-srv/assets/websites-table.c794d196f321659ff795e7456e8c1438.png) Dans cette image d’exemple, cliquez sur la ligne powdur.me du tableau. 1. Vous devriez être redirigé vers la page d’administration de votre domaine. 1. À gauche de l’écran, cliquez sur **DNS**. 1. Vous devriez voir apparaître une page de gestion DNS pour votre domaine : ![Vue DNS](https://b.stripecdn.com/docs-statics-srv/assets/dns-panel.deb9b0988ff2b2864d39ccd498d7c351.png) - [ ] Créer votre enregistrement CNAME Ajoutez un nouvel enregistrement qui mappe le sous-domaine de votre choix vers Stripe Checkout. 1. Cliquez sur **Ajouter un enregistrement**. 1. Saisissez ces valeurs dans le formulaire qui s’affiche à l’écran : | Champ | Valeur à saisir | Description | | ----------------- | ----------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------- | | **Type** | Sélectionnez `CNAME` dans la liste déroulante. | Type de l’enregistrement DNS. | | **Cible** | Si votre sous-domaine personnalisé est **checkout.powdur.me**, saisissez `checkout` | Pour les enregistrements CNAME, ce champ est identique à la première partie de votre sous-domaine (située avant le premier point). | | **Valeur** | `hosted-checkout.stripecdn.com` | Destination vers laquelle pointe le nouvel enregistrement du sous-domaine (ici, Stripe Checkout). | | **TTL** | `5 min` | Un délai d’expiration de 5 minutes (300 secondes) est acceptable. | | **État du proxy** | `Off` | Pour éviter tout problème pendant la configuration, définissez l’état du proxy sur `off`. | ![Apparence du formulaire rempli, pour un exemple de domaine](https://b.stripecdn.com/docs-statics-srv/assets/filled-form-cname.fd46677b9723447c3f718939e97b8007.png) Un exemple de formulaire renseigné pour l’ajout de votre enregistrement CNAME. 1. Cliquez sur **Enregistrer**. 1. Vous verrez apparaître une nouvelle ligne de tableau correspondant au nouvel enregistrement DNS, contenant les valeurs suivantes : - **Type** : `CNAME` - **Nom** : `` - **Contenu** : `hosted-checkout.stripecdn.com` - **État du proxy** : DNS uniquement - **TTL** : 5 minutes - [ ] Créer votre enregistrement TXT Depuis le panneau de contrôle de votre fournisseur DNS, ajoutez un nouvel enregistrement TXT. > Cet enregistrement TXT nous permet de vérifier que vous êtes bien le propriétaire de ce domaine. Nous en avons besoin pour délivrer des certificats TLS pour votre domaine, afin que vous puissiez continuer à accepter des paiements en toute sécurité. 1. Cliquez sur **Ajouter un enregistrement**. 1. Saisissez ces valeurs dans le formulaire qui s’affiche à l’écran : | Champ | Valeur à saisir | Description | | ----------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------- | | **Type** | Sélectionner `TXT` dans la liste déroulante | Type de l’enregistrement DNS. | | **Nom** | Si votre domaine personnalisé est **checkout.powdur.me**, saisissez `_acme-challenge.checkout` | Pour les enregistrements TXT, ce champ est identique à la partie de votre domaine correspondant à votre sous-domaine. | | **Contenu** | Accédez aux [paramètres du Dashboard](https://dashboard.stripe.com/settings/custom-domains), puis cliquez sur **Afficher les instructions** pour copier le bon enregistrement de valeur TXT. | Il s’agit d’une longue chaîne unique utilisée à des fins de vérification du domaine. | | **TTL** | `5 min` | Un délai d’expiration de 5 minutes (300 secondes) est acceptable. | ![Apparence du formulaire rempli, pour un exemple de domaine](https://b.stripecdn.com/docs-statics-srv/assets/filled-form-txt.5d164d597718eff86d45e6ce1e8d2d6a.png) Un exemple de formulaire renseigné pour l’ajout de votre enregistrement TXT. 1. Cliquez sur **Enregistrer**. 1. Vous verrez apparaître une nouvelle ligne de tableau correspondant au nouvel enregistrement DNS, contenant les valeurs suivantes : - **Type** : `TXT` - **Nom** : `_acme-challenge.` - **Contenu** : `` - **État du proxy** : DNS uniquement - **TTL** : 5 minutes - [ ] Vérifier que votre enregistrement CNAME est correctement configuré Une fois que vous avez sauvegardé votre enregistrement DNS, vérifiez que les valeurs sont correctes. #### Procéder à la vérification depuis votre terminal 1. Patientez jusqu’à 10 minutes le temps que votre fournisseur DNS mette à jour ses serveurs de noms. 1. Exécutez la commande suivante sur votre terminal en remplaçant **checkout.powdur.me** par votre domaine personnalisé : ```bash nslookup -querytype=CNAME checkout.powdur.me ``` Vous devriez obtenir le résultat suivant : ``` canonical name = hosted-checkout.stripecdn.com. ``` Lorsque vous obtenez ce résultat, passez à l’étape suivante. #### Procéder à la vérification depuis votre navigateur Web 1. Patientez jusqu’à 10 minutes le temps que votre fournisseur DNS mette à jour ses serveurs de noms. 1. Ouvrez l’outil [NSLookup Online Tool](https://coding.tools/nslookup). 1. Saisissez votre nom de domaine personnalisé dans le champ **Domain or IP Address**. 1. Dans la liste déroulante **Query Type**, sélectionnez **CNAME (Canonical name record)**. 1. Cliquez sur **Nslookup** pour rechercher votre enregistrement CNAME. Le résultat doit afficher `canonical name = hosted-checkout.stripecdn.com` (le cas échéant, passez à l’étape suivante). Sinon, patientez quelques instants et exécutez à nouveau la requête. - [ ] Vérifier votre enregistrement TXT Une fois que vous avez sauvegardé votre enregistrement DNS, vérifiez que les valeurs sont correctes. #### Procéder à la vérification depuis votre terminal 1. Patientez jusqu’à 10 minutes le temps que votre fournisseur DNS mette à jour ses serveurs de noms. 1. Exécutez la commande suivante sur votre terminal en remplaçant **checkout.powdur.me** par votre domaine personnalisé : ```bash nslookup -querytype=TXT _acme-challenge.checkout.powdur.me ``` Vous devriez obtenir le résultat suivant : ``` _acme-challenge. text = "" ``` Si le résultat n’affiche pas la valeur unique de votre enregistrement TXT, patientez quelques instants et exécutez à nouveau la commande. #### Procéder à la vérification depuis votre navigateur Web 1. Patientez jusqu’à 10 minutes le temps que votre fournisseur DNS mette à jour ses serveurs de noms. 1. Ouvrez l’outil [NSLookup Online Tool](https://coding.tools/nslookup). 1. Saisissez `_acme-challenge.[your custom domain name]` dans le champ **Domain or IP Address**. 1. Dans la liste déroulante **Query Type**, sélectionnez **TXT (Text record)**. 1. Cliquez sur **Nslookup** pour rechercher votre enregistrement CNAME. Le résultat doit afficher la valeur de l’enregistrement TXT que vous avez saisie à l’étape précédente. Dans le cas contraire, patientez quelques instants et exécutez à nouveau la requête. Une fois que vous avez complété cette étape, la configuration de vos enregistrements DNS est terminée. Pour en savoir plus, consultez les guides officiels de Cloudflare destinés aux développeurs, notamment celui intitulé [Gérer les enregistrements DNS](https://developers.cloudflare.com/dns/manage-dns-records/how-to/create-dns-records/). > Si la vérification de vos enregistrements DNS ou de votre domaine semble très lente, essayez de définir l’aplatissement CNAME sur > > **Aplatir le CNAME à la racine**> > . Vous trouverez ce paramètre dans votre Dashboard Cloudflare sous > > **DNS**> >  > > > **Settings**> >  > > > **Aplatissement CNAME**> > . Si la définition de l’aplatissement CNAME ne résout pas le problème, > > [contactez le service Support de Stripe](https://support.stripe.com/)> > . Une fois que vous avez créé et validé vos enregistrements DNS, Stripe vérifie la connexion et implémente votre domaine de son côté. Nous vous enverrons un e-mail ainsi qu’une notification dans votre Dashboard lorsque le domaine sera prêt pour activation de votre côté. Vous pouvez également à tout moment consulter les [paramètres du Dashboard](https://dashboard.stripe.com/settings/custom-domains) pour examiner l’état de la connexion de votre domaine personnalisé. ## Optional: Tester votre domaine personnalisé ### Créer un lien de paiement test Vous recevez une notification lorsque votre domaine personnalisé est ajouté et activé pour les tests. 1. Accédez aux [paramètres du Dashboard](https://dashboard.stripe.com/settings/custom-domains). 1. Vérifiez que l’indicateur `Added` est affiché au-dessus de votre nom de domaine personnalisé. 1. [Créer un lien de paiement](https://docs.stripe.com/payment-links/create.md) en mode test. Votre nouveau domaine personnalisé s’affiche sur la page relative aux informations sur votre lien de paiement nouvellement créé. > L’ajout de domaines personnalisés n’est actuellement pas pris en charge dans les environnements de test. ## Optional: Suppression de votre domaine personnalisé Vous pouvez, si vous le souhaitez, supprimer votre domaine personnalisé. Le cas échéant, vous devez supprimer tous les enregistrements DNS créés pour votre sous-domaine personnalisé et suivre les étapes détaillées dans ce guide pour le rétablir. Pour supprimer votre domaine personnalisé : 1. Accédez aux [paramètres du Dashboard](https://dashboard.stripe.com/settings/custom-domains) pour consulter vos domaines personnalisés. 1. Cliquez sur le bouton **Supprimer**. 1. Lisez la fenêtre contextuelle de confirmation, puis cliquez sur **Supprimer** pour confirmer la suppression. 1. Connectez-vous à votre fournisseur DNS et supprimez les deux enregistrements DNS que vous avez créés précédemment pour votre sous-domaine personnalisé. > Une fois votre abonnement annulé, les liens de paiement et le lien vers le portail client qui utilisent votre domaine personnalisé cesseront de fonctionner. Vous pourrez copier et partager de nouvelles URL `buy.stripe.com` ou `billing.stripe.com` pour chacun de vos liens existants. ## Optional: Utilisation de domaines personnalisés avec Connect | Type d’intégration Connect | Description | À quel compte appartient le domaine personnalisé utilisé ? | | --------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | --------------------------------------------------------------- | | Paiement indirect | Votre intégration utilise `payment_intent_data[transfer_data][destination]`. Pour en savoir plus, consultez la [documentation](https://docs.stripe.com/connect/destination-charges.md). | Le domaine du **compte de la plateforme**. | | Paiement direct | Votre intégration transmet l’ID du compte connecté dans l’en-tête `Stripe-Account`. Pour en savoir plus, consultez la [documentation](https://docs.stripe.com/connect/direct-charges.md). | Le domaine du **compte connecté**. | | Paiements et transferts distincts | Les paiements et les transferts sont traités en dehors de la session Checkout. Pour en savoir plus, consultez la [documentation](https://docs.stripe.com/connect/separate-charges-and-transfers.md). | Le domaine du **compte de la plateforme**. | > #### Paiements indirects avec on_behalf_of > > Checkout Sessions et Payment Links qui utilisent [`on_behalf_of`](https://docs.stripe.com/connect/destination-charges.md#settlement-merchant) utilisent toujours le domaine Stripe par défaut (`checkout.stripe.com` ou `buy.stripe.com`) au lieu d’un domaine personnalisé. Cela garantit une prise en charge cohérente des moyens de paiement wallet tels qu’Apple Pay. ## Optional: Résolution des problèmes liés à votre intégration Si vous avez suivi ce guide et activé votre domaine personnalisé en mode production, mais qu’il ne fonctionne pas pour vos sessions Checkout, il est possible que vous utilisiez un type d’intégration Checkout qui n’est pas pris en charge. Stripe propose trois types d’intégrations Checkout. Toutefois, à l’heure actuelle, nous prenons uniquement en charge les redirections côté serveur. Consultez le tableau suivant pour déterminer le type d’intégration que vous utilisez : | Type d’intégration | Vous utilisez ce type d’intégration si… | Remarques | Fonctionne avec des domaines personnalisés ? | | -------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------- | ------------------------------------------------- | | Intégration client | Si vous ne créez pas de sessions Checkout depuis votre serveur et que vous utilisez uniquement [stripe.redirectToCheckout](https://docs.stripe.com/js/deprecated/redirect_to_checkout) côté client en fournissant des éléments tels que des unités de gestion des stocks ou des plans. | Ce chemin d’intégration est obsolète. | **✗ Non** | | Création des sessions Checkout côté serveur et `stripe.redirectToCheckout` côté client | Si vous créez des sessions Checkout depuis votre serveur et que vous redirigez vos clients côté client en utilisant [stripe.redirectToCheckout](https://docs.stripe.com/js/deprecated/redirect_to_checkout) et en utilisant l’ID de la session Checkout. | Il s’agissait du chemin d’intégration documenté standard avant septembre 2021. | **✗ Non** | | Création des sessions Checkout et redirection côté serveur | Si vous créez des sessions Checkout et que vous redirigez vos clients vers l’[URL](https://docs.stripe.com/api/checkout/sessions/object.md#checkout_session_object-url) renvoyée dans la réponse côté serveur. Consultez le guide [Accepter un paiement](https://docs.stripe.com/payments/accept-a-payment.md?integration=checkout) pour voir un exemple. | Il s’agit du chemin d’intégration documenté standard depuis septembre 2021. | **✓ Oui** | Si le type d’intégration que vous utilisez n’est pas pris en charge, consultez notre guide [Accepter un paiement](https://docs.stripe.com/payments/accept-a-payment.md?integration=checkout) pour passer à une redirection côté serveur et utiliser des domaines personnalisés. ## Optional: Résolution des problèmes liés aux enregistrements DNS CAA Vous êtes susceptible de rencontrer les problèmes liés aux enregistrements DNS CAA suivants lorsque vous essayez d’ajouter un domaine personnalisé à Checkout : - Votre enregistrement CAA ne considère pas `letsencrypt.org` comme un émetteur d’autorités de certification valide. - Vous avez un enregistrement CAA au même niveau que votre nom de domaine personnalisé. ### Votre enregistrement CAA ne considère pas letsencrypt.org comme un émetteur d’autorités de certification valide Stripe utilise [Let’s Encrypt](https://letsencrypt.org) pour générer des certificats TLS pour votre domaine personnalisé. Cela permet de s’assurer que toutes les requêtes sont sécurisées et chiffrées. Par conséquent, si vous avez un enregistrement DNS `CAA` existant, vous devez ajouter `letsencrypt.org` comme émetteur valide. Pour ajouter Let’s Encrypt comme émetteur : 1. Depuis le panneau de contrôle de votre fournisseur DNS, recherchez l’enregistrement `CAA` existant pour votre domaine et prenez ses valeurs actuelles en note. 1. Ajoutez un nouvel enregistrement au même niveau que vos autres enregistrements `CAA`, puis saisissez les valeurs suivantes : - **Nom** : doit être identique à celui de vos autres enregistrements CAA. Le symbole `@` est utilisé comme caractère générique pour les enregistrements CAA à la racine du domaine (par exemple, `powdur.me`). - **Flags** : `0` - **Balise** : `issue` - **Valeur** : `letsencrypt.org` - **TTL** : 3 600 secondes (1 heure) est une valeur par défaut acceptable. 1. Sauvegardez l’enregistrement. La majorité des mises à jour DNS prennent effet dans l’heure, mais certaines peuvent prendre jusqu’à 72 heures pour être effective à l’échelle mondiale. Pour en savoir plus sur la configuration des enregistrements Let’s Encrypt CAA, consultez le [guide sur les CAA](https://letsencrypt.org/docs/caa/) dédié. ### Votre enregistrement CAA est au même niveau que votre nom de domaine personnalisé Si vous avez reçu un rapport d’erreur sur le Dashboard indiquant que votre enregistrement CAA est au même niveau que votre nom de domaine personnalisé, cela signifie qu’il existe déjà un enregistrement DNS `CAA` pour le nom de domaine personnalisé que vous essayez de connecter à Checkout. Par exemple, si vous essayez de connecter **checkout.powdur.me** à Checkout mais qu’il existe déjà un enregistrement DNS `CAA` pour ce domaine, Stripe vous renvoie une erreur. Plusieurs solutions existent à ce problème : 1. Vous pouvez descendre l’enregistrement `CAA` d’un niveau : - Si vous voulez donner un nom de domaine personnalisé à **checkout.powdur.me**, vous pouvez créer une copie de l’enregistrement `CAA` avec les mêmes valeurs dans **powdur.me**. - Une fois que le nouvel enregistrement `CAA` s’est propagé, vous pouvez retirer l’enregistrement `CAA` incompatible de votre fournisseur DNS en toute sécurité. - Une fois que la suppression s’est propagée, vous pouvez essayer une nouvelle fois d’ajouter votre domaine personnalisé au Dashboard. 1. Vous pouvez choisir un nom de domaine personnalisé au-dessus de votre enregistrement `CAA`. - Si votre enregistrement `CAA` se trouve sur **checkout.powdur.me**, vous pouvez choisir un nom de domaine personnalisé, par exemple **pay.checkout.powdur.me**. ## Optional: Résolution des problèmes d'un domaine bloqué Cloudflare, notre fournisseur de domaine, bloque parfois l’ajout automatique de certains domaines à Cloudflare dans le cadre d’un contrôle de sécurité supplémentaire. Si vous voyez un message d’erreur dans les [paramètres du Dashboard](https://dashboard.stripe.com/settings/custom-domains) à propos du blocage de votre domaine par Cloudflare, vous pouvez envoyer un e-mail à [abusereply@cloudflare.com](mailto:abusereply@cloudflare.com) afin de faire corriger le problème. Lorsque vous envoyez un e-mail à Cloudflare, copiez et collez ce modèle d’e-mail et remplacez tous les **[emplacements réservés]** en gras par vos propres données : **À :** abusereply@cloudflare.com **Sujet :** Débloquer la requête pour **[insérez votre nom de domaine]** Cloudflare, Nous ajoutons actuellement un nom de domaine personnalisé à Stripe Checkout qui exploite Cloudflare. il est bloqué par votre compte. Pouvez-vous débloquer ce nom de domaine pour nous ? Domaine ou nom d’hôte que nous essayons d’ajouter : **[insérez votre nom de domaine]** Association avec le domaine : **[fournir une explication de votre association avec/propriété du domaine]** N’hésitez pas à nous contacter si vous avez des questions supplémentaires. Merci, **[Votre nom]** # Formulaire intégré > This is a Formulaire intégré for when payment-ui is embedded-form. View the full page at https://docs.stripe.com/payments/checkout/custom-domains?payment-ui=embedded-form. Cette fonctionnalité ne s’applique pas à l’utilisation du formulaire intégré, puisqu’il est intégré à votre site Web. # Composants intégrés > This is a Composants intégrés for when payment-ui is embedded-components. View the full page at https://docs.stripe.com/payments/checkout/custom-domains?payment-ui=embedded-components. Cette fonctionnalité ne s’applique pas à l’utilisation de composants intégrés, puisqu’ils sont intégrés à votre site Web.