Utiliser votre domaine personnalisé

Découvrez comment utiliser votre propre domaine personnalisé avec Stripe Checkout, Payment Links et le portail client.

Si vous utilisez la page hébergée par Stripe pour Checkout, vous pouvez ajouter votre propre domaine personnalisé à Stripe. L’ajout de domaines personnalisés est une fonctionnalité payante. Pour plus d’informations sur les coûts, consultez la page Tarifs 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.

Remarque

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 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 :

Command Line
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 :

nslookup output

# 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 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 :

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.

Remarque

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.

Remarque

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.

Remarque

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, 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.
Patientez jusqu’à 10 minutes le temps que votre fournisseur DNS mette à jour ses serveurs de noms.
Exécutez la commande suivante sur votre terminal en remplaçant checkout.powdur.me par votre domaine personnalisé :
Command Line
nslookup -querytype=CNAME checkout.powdur.me
Vous devriez obtenir le résultat suivant :
nslookup output
<your subdomain> canonical name = hosted-checkout.stripecdn.com.
Lorsque vous obtenez ce résultat, passez à l’étape suivante.
Vérifier votre enregistrement TXT
Une fois que vous avez sauvegardé votre enregistrement DNS, vérifiez que les valeurs sont correctes.
Patientez jusqu’à 10 minutes le temps que votre fournisseur DNS mette à jour ses serveurs de noms.
Exécutez la commande suivante sur votre terminal en remplaçant checkout.powdur.me par votre domaine personnalisé :
Command Line
nslookup -querytype=TXT _acme-challenge.checkout.powdur.me
Vous devriez obtenir le résultat suivant :
nslookup output
_acme-challenge.<your domain> text = "<your unique TXT record value>"
Si le résultat n’affiche pas la valeur unique de votre enregistrement TXT, patientez quelques instants et exécutez à nouveau la commande.
Une fois que vous avez complété cette étape, la configuration de vos enregistrements DNS est terminée.

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 pour examiner l’état de la connexion de votre domaine personnalisé.

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

Accédez aux paramètres du Dashboard.
Vérifiez que l’indicateur Added est affiché au-dessus de votre nom de domaine personnalisé.
Créez un lien de paiement dans un environnement de test.

Votre nouveau domaine personnalisé s’affiche sur la page relative aux informations sur votre lien de paiement nouvellement créé.

FacultatifSuppression 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é :

Accédez aux paramètres du Dashboard pour consulter vos domaines personnalisés.
Cliquez sur le bouton Supprimer.
Lisez la fenêtre contextuelle de confirmation, puis cliquez sur Supprimer pour confirmer la suppression.
Connectez-vous à votre fournisseur DNS et supprimez les deux enregistrements DNS que vous avez créés précédemment pour votre sous-domaine personnalisé.

Remarque

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.

FacultatifUtilisation de domaines personnalisés avec Connect

Lorsque vous combinez des domaines personnalisés avec une intégration Connect, nous appliquons les mêmes règles qu’à nos autres paramètres de marque :

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.	Le domaine du compte de la plateforme.
`on_behalf_of`	Semblable au paiement indirect, mais l’entité de règlement est différente. Pour en savoir plus, consultez la documentation.	Le domaine du compte connecté.
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.	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.	Le domaine du compte de la plateforme.

FacultatifRé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 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 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 renvoyée dans la réponse côté serveur. Consultez le guide Accepter un paiement 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 pour passer à une redirection côté serveur et utiliser des domaines personnalisés.

FacultatifRé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 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 :

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

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

FacultatifRé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 à propos du blocage de votre domaine par Cloudflare, vous pouvez envoyer un e-mail à 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]