Enregistrer des domaines pour des moyens de paiement
Enregistrez et vérifiez des domaines pour utiliser les moyens de paiement (dont Link, Apple Pay et Google Pay) dans Elements ou le formulaire de paiement intégrable de Checkout.
Pour utiliser certains moyens de paiement avec Elements ou le formulaire de paiement intégrable de Checkout, vous devez enregistrer tous les domaines Web sur lesquels figurera le moyen de paiement concerné, y compris les domaines principaux et les sous-domaines. Par exemple, si vous possédez le domaine yourdomain.com et les sous-domaines shop.yourdomain.com et www.yourdomain.com, ce guide vous explique comment les enregistrer.
Une fois votre domaine enregistré, celui-ci est prêt à être utilisé avec tous les autres moyens de paiement que vous pourriez ajouter à l’avenir.
Les moyens de paiement suivants nécessitent une inscription :
- Google Pay
- Link
- PayPal
- Amazon Pay
- Apple Pay (étape de vérification supplémentaire requise)
Apple Pay et la validation des marchands
La documentation d’Apple Pay sur le Web décrit son processus d’approbation des marchands, que Stripe gère directement pour vous. Vous n’avez pas besoin de créer d’ID de marchand Apple, ni de demande de signature de certificat. Il vous suffit de procéder comme indiqué dans ce guide.
Test
Vous devez également enregistrer des domaines à des fins de test. Lors du test en local, vous pouvez utiliser un outil tel que ngrok pour obtenir un domaine HTTPS. Vous pouvez enregistrer en mode test ou en mode production et le domaine sera également enregistré en mode test automatiquement. N’oubliez pas d’enregistrer vos domaines en mode production avant la mise en production.
Vous pouvez créer et gérer des domaines dans le Dashboard en accédant à la page des domaines de moyens de paiement à des fins de production comme de test.
Utilisation de Connect
Les plateformes Connect qui créent des paiements directs doivent utiliser l’API pour gérer les domaines de leurs comptes connectés, et non le Dashboard Stripe.
Enregistrer votre domaine
Pour enregistrer un domaine :
- Sur la page des domaines des moyens de paiement, cliquez sur Ajouter un domaine.
- Saisissez votre nom de domaine.
- Cliquez sur Enregistrer et continuer.
- Si vous configurez Apple Pay, vérifiez la propriété de votre domaine auprès d’Apple en suivant les étapes décrites plus loin sur cette page.
- (Facultatif) Répétez les étapes 1 à 4 pour chaque autre domaine à enregistrer.
Une fois ces étapes terminées, votre domaine apparaîtra sur la page des domaines des moyens de paiement.
Utiliser un iframe
- Utilisation d’un iframe avec Elements : lors de l’utilisation d’un iframe, son origine doit correspondre à l’origine de niveau supérieur (sauf pour Safari 17 lorsque vous précisez l’attribut
allow="payment"). Deux pages ont la même origine si le protocole, l’hôte (nom de domaine complet) et le port (le cas échéant) sont les mêmes pour les deux pages. - Domaine de niveau supérieur et domaine iframe : si le domaine de niveau supérieur diffère du domaine iframe, le domaine de niveau supérieur et le domaine source de l’iframe doivent être des domaines de moyen de paiement enregistré sur le compte associé.
Vérifier la propriété de votre domaine auprès d’Apple Pay
Lors de l’inscription, Stripe tente automatiquement de vérifier la propriété de votre domaine auprès d’Apple. Si votre domaine n’est pas encore vérifié, enregistrez-le puis suivez ces étapes pour le vérifier auprès d’Apple Pay.
Erreur fréquente
Apple tente de demander votre fichier d’association de domaines, auquel les serveurs d’Apple doivent donc pouvoir accéder.
- Télécharger le fichier d’association de domaine.
- Hébergez le fichier dans
/.. Par exemple, si vous enregistrezwell-known/apple-developer-merchantid-domain-association https://yourdomain., placez ce fichier à l’adressecom https://yourdomain..com/. well-known/apple-developer-merchantid-domain-association - Cliquez sur Vérifier.
Gérer votre domaine
Vous pouvez voir la liste de tous vos domaines dans le Dashboard.
Pour désactiver un domaine, cliquez sur l’action de la ligne, puis sur Désactiver. Si un domaine est désactivé, les moyens de paiement n’apparaissent plus dans le formulaire de paiement intégrable d’Elements ou de Checkout pour ce domaine.
Pour activer un domaine désactivé, cliquez sur l’action de la ligne, puis sur Activer.
Enregistrer un domaine avec Connect
Les plateformes Connect doivent enregistrer tous les domaines dans lesquels le formulaire de paiement intégrable d’Elements ou de Checkout affiche les moyens de paiement indiqués ci-dessus. Le domaine sur lequel le paiement est exécuté doit être enregistré pour l’utilisateur qui effectue le paiement.
Si la plateforme crée des paiements directs, authentifiez la requête avec la clé secrète de votre plateforme et spécifiez l’ID de votre compte connecté dans l’en-tête Stripe-Account.
Si la plateforme crée des paiements indirects ou des paiements et transferts distincts, authentifiez la requête avec la clé secrète de votre plateforme et omettez l’en-tête Stripe-Account.
En savoir plus sur l’exécution d’appels à l’API pour les comptes connectés.