Enregistrer des domaines pour des moyens de paiement
Enregistrez des domaines pour utiliser des moyens de paiement (notamment 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
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 pour effectuer des tests. Lorsque vous effectuez des tests en local, vous pouvez utiliser un outil tel que ngrok pour obtenir un domaine HTTPS. Vous pouvez soit inscrire le domaine dans un environnement de test, soit le faire en mode production, auquel cas le domaine sera également enregistré automatiquement dans les environnements de test. N’oubliez pas d’enregistrer vos domaines en mode production avant de passer 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.
- (Facultatif) Répétez les étapes 1 à 3 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é.
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.