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 :
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.
Enregistrer votre domaine
Pour enregistrer un domaine, procédez comme suit :
Répétez l’opération pour tous les domaines à enregistrer.
Utiliser un iframe
- Lorsque vous utilisez un iframe, son origine doit correspondre à l’origine de niveau supérieur, sauf dans Safari 17+. 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.
- Lorsque vous utilisez un iframe d’origines multiples dans Safari 17+, vous devez spécifier l’attribut
allow=“payment”. Pour activer Apple Pay, vous devez également enregistrer le domaine source que l’iframe charge.
Gérer votre domaine
À l’aide de l’API PaymentMethodDomain, vous pouvez effectuer les actions suivantes :
- Récupérer un domaine.
- Consulter la liste de vos domaines.
- Activer ou désactiver un domaine. 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.
Cet exemple montre comment désactiver un domaine :
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.