Configurations des moyens de paiement
Créez différents groupes de moyens de paiement à proposer aux clients en fonction de scénarios de paiement spécifiques.
La configuration des moyens de paiement permet aux utilisateurs de moyens de paiement dynamiques de proposer différents groupes de moyens de paiement aux clients en fonction de scénarios de paiement spécifiques.
Vous pouvez créer une configuration pour :
- Affichez un groupe de moyens de paiement unique pour certains produits
- Activez un groupe de moyens de paiement pour votre tunnel de paiement ponctuel et un autre groupe de moyens de paiement pour votre tunnel de paiement d’abonnement
- Connect Offrez à vos comptes connectés la possibilité d’accéder à des moyens de paiement supplémentaires moyennant des frais d’abonnement différents
Une fois que vous avez créé une configuration de moyens de paiement, vous pouvez activer ou désactiver chaque moyen de paiement pour un scénario donné directement dans le Dashboard, sans rédiger une seule ligne de code. Ensuite, au moment du paiement, sélectionnez la configuration que vous souhaitez utiliser. Stripe classe les moyens de paiement activés dans cette configuration afin d’optimiser la conversion.
Avant de commencer
- Vous devez utiliser le composant Payment Element ou Checkout.
- Vous devez utiliser les moyens de paiement dynamiques pour activer des moyens de paiement supplémentaires à partir du Dashboard Stripe sans avoir à modifier le code.
- Afin de configurer des moyens de paiement dynamiques pour les utilisateurs directs, consultez le guide d’intégration des moyens de paiement
- Connect Afin de configurer des moyens de paiement dynamiques pour les plateformes Connect, consultez la page Passer aux moyens de paiement dynamiques.
Créer une configuration de moyen de paiement
Vous disposez par défaut d’une configuration de moyen de paiement appelée Configuration par défaut. Vous pouvez créer d’autres configurations de moyens de paiement à l’aide du Dashboard Stripe et de l’API.
- Dans votre Dashboard, accédez aux paramètres des moyens de paiement.
- Dans la section Configurations des paiements, cliquez sur le menu débordant () > Créer une configuration.
- Nommez votre nouvelle configuration.
- Cliquez sur Enregistrer la configuration.

La page affiche votre nouvelle configuration. Tous les moyens de paiement sont initialement désactivés par défaut.
Pour naviguer entre les configurations, utilisez la liste déroulante Sélectionner une configuration en haut de la page.
Pour vous assurer que la configuration du moyen de paiement que vous souhaitez activer est définie sur active dans le Dashboard :
- Passez aux paramètres de vos moyens de paiements.
- Cliquez sur un moyen de paiement dans la section Configurations des paiements, puis cliquez sur le menu débordant () > Gestion de la configuration.
- Sous État de la configuration, activez l’option Active.
- Cliquez sur Enregistrer les modifications pour appliquer vos mises à jour.
Activer des moyens de paiement
Dans le Dashboard, ouvrez la configuration et activez les moyens de paiement que vous souhaitez proposer aux acheteurs qui utilisent cette configuration. Seuls les moyens de paiement activés et compatibles avec la devise et l’emplacement du paiement sont visibles par un acheteur.
Remarque
Certains moyens de paiement n’affichent les champs de saisie que lorsque vous les développez.
Afficher les moyens de paiement disponibles lors du paiement
Dans le Dashboard, copiez l’ID configuration ID correspondant à la configuration que vous souhaitez utiliser dans votre tunnel de paiement.
Si vous utilisez le chemin d’intégration avec création différée des Intents, transmettez l’ID payment_ lorsque vous créez votre Payment Element. Le Payment Element récupère automatiquement les moyens de paiement associés à cette configuration et les classe mieux convertir les clients.
const options = { mode: 'payment', amount: 1099, currency: 'usd', paymentMethodConfiguration: 'pmc_234' }
Si vous n’utilisez pas de Payment Element, transmettez l’ID payment_ lorsque vous créez une session Checkout.
curl https://api.stripe.com/v1/checkout/sessions \ -u ":" \ -d mode=payment \ -d "line_items[0][price]=sk_test_VePHdqKTYQjKNInc7u56JBrQ" \ -d "line_items[0][quantity]=1" \ --data-urlencode "success_url=https://example.com/success" \ -d currency=usd \ -d payment_method_configuration=pmc_234{{PRICE_ID}}
Moyens de paiement
Par défaut, Stripe active les cartes bancaires et autres moyens de paiement courants. Vous avez la possibilité d’activer ou de désactiver des moyens de paiement directement depuis le Dashboard Stripe. Dans Checkout, Stripe évalue la devise et les restrictions éventuelles, puis présente dynamiquement au client les moyens de paiement pris en charge.
Pour voir comment vos moyens de paiement s’affichent pour les clients, saisissez un ID de transaction ou définissez le montant et la devise d’une commande sur la page Vérification des moyens de paiement du Dashboard.
Checkout prend en charge Apple Pay et Google Pay sans modifications au niveau de l’intégration. Découvrez comment tester les wallets.
Créer un PaymentIntent avec la configuration
Créez un PaymentIntent sur votre serveur à l’aide de la configuration du moyen de paiement.
Dans la dernière version de l’API, le paramètre automatic_ est facultatif car il est activé par défaut.
Exclure des moyens de paiement pour un PaymentIntent spécifique
Bien que vous puissiez gérer les moyens de paiement individuellement, vous pouvez également exclure certains moyens de paiement en fonction de chaque transaction à l’aide du paramètre excluded_ lorsque vous utilisez PaymentIntents, SetupIntents, Checkout ou PaymentElement.
Configurations de moyens de paiement multiples lorsque :
- Vous devez gérer les moyens de paiement pour des catégories plus larges de transactions. Par exemple, vous pouvez vouloir configurer différents ensembles de moyens de paiement pour les achats ponctuels par rapport aux abonnements. Utilisez cette approche lorsque vous souhaitez établir des offres de moyens de paiement cohérentes pour des types de transactions similaires.
Utiliser exclude_payment_method_types lorsque :
- Vous avez besoin de plus de contrôle sur les combinaisons de moyens de paiement qui seraient peu pratiques à implémenter avec plusieurs configurations de moyens de paiement.
- Vous souhaitez contrôler les moyens de paiement que vous présentez. Par exemple, vous pouvez exclure certains moyens de paiement en fonction des éléments inclus dans la transaction.
Vous pouvez utiliser le paramètre excluded_ avec les configurations des moyens de paiement pour contrôler la disponibilité des moyens de paiement.
Remarque
Vous ne pouvez pas exclure Apple Pay, Google Pay ou Link par transaction à l’aide de excluded_. Si vous souhaitez contrôler la visibilité de ces moyens de paiement pour une transaction donnée, utilisez les paramètres de hachage des wallets qui sont spécifiés par type d’intégration. Par exemple, consultez le paramètre de wallet PaymentElements.
Découvrez comment exclure des moyens de paiement.