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.

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.

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.

Télécharger le fichier d’association de domaine.
Hébergez-le sur votre site dans /.well-known/apple-developer-merchantid-domain-association. Par exemple, si vous enregistrez https://yourdomain.com, placez ce fichier à l’adresse https://yourdomain.com/.well-known/apple-developer-merchantid-domain-association.

Stripe effectue une vérification initiale du domaine à l’aide de requêtes provenant de l’une de nos IP de webhook.

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.