# 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](https://docs.stripe.com/payments/payment-methods/dynamic-payment-methods.md) 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. ## Before you begin - Vous devez utiliser le [composant Payment Element](https://docs.stripe.com/payments/payment-element.md) ou [Checkout](https://docs.stripe.com/payments/checkout.md). - Vous devez utiliser les [moyens de paiement dynamiques](https://docs.stripe.com/payments/payment-methods/dynamic-payment-methods.md) 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](https://docs.stripe.com/payments/payment-methods/dynamic-payment-methods.md) - (Connect) Pour configurer des moyens de paiement dynamiques pour les plateformes Connect, consultez la page [Gérer les moyens de paiement des comptes connectés](https://docs.stripe.com/connect/manage-payment-methods.md). ## 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. #### Dashboard 1. Dans votre Dashboard, accédez aux [paramètres des moyens de paiement](https://dashboard.stripe.com/test/settings/payment_methods). 2. Dans la section **Configurations des paiements**, cliquez sur le menu débordant (⋯) > **Créer une configuration**. 3. Nommez votre nouvelle configuration. 4. Cliquez sur **Enregistrer la configuration**. ![Page de configuration des moyens de paiement](https://b.stripecdn.com/docs-statics-srv/assets/payment-method-configurations.a766550ad4dd95854a7a9b9f178e1d45.png) 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 : 1. Passez aux paramètres de vos moyens de paiements. 2. Cliquez sur un moyen de paiement dans la section **Configurations des paiements**, puis cliquez sur le menu débordant (⋯) > **Gestion de la configuration**. 3. Sous **État de la configuration**, activez l’option **Active**. 4. Cliquez sur **Enregistrer les modifications** pour appliquer vos mises à jour. #### API Créez une [configuration de moyen de paiement](https://docs.stripe.com/api/payment_method_configurations/create.md) avec les paramètres suivants : - `name` : une chaîne lisible par l’homme qui apparaît dans le Dashboard. - (Facultatif) Un ou plusieurs moyens de paiement à activer pour cette configuration. Définissez chaque valeur sur `on`. ```curl curl https://api.stripe.com/v1/payment_method_configurations \ -u "<>:" \ -d name=MyConfig \ -d "affirm[display_preference][preference]=on" \ -d "klarna[display_preference][preference]=on" ``` Après avoir créé la configuration, accédez au Dashboard pour y ajouter des moyens de paiement. ## Activer des moyens de paiement Dans le Dashboard, ouvrez la configuration et activez les moyens de paiement que vous souhaitez proposer aux clients qui l’utilisent. Les clients ne voient que les moyens de paiement activés et compatibles avec le lieu et la devise du paiement. > 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 [parcours d’intégration avec création différée de l’intention](https://docs.stripe.com/payments/accept-a-payment-deferred.md), transmettez l’ID `payment_method_configuration` lorsque vous créez votre composant Payment Element. Le composant Payment Element récupère automatiquement les moyens de paiement associés à cette configuration et les classe de manière à maximiser les conversions. #### Web ```javascript const options = { mode: 'payment', amount: 1099, currency: 'usd', paymentMethodConfiguration: 'pmc_234' } ``` #### iOS ```swift let intentConfig = PaymentSheet.IntentConfiguration( mode: .payment(amount: 1099, currency: "USD"), paymentMethodConfigurationId: "pmc_234" ) { [weak self] _, intentCreationCallback in self?.handleConfirm(intentCreationCallback) } ``` #### Android ```kotlin val intentConfig = PaymentSheet.IntentConfiguration( mode = PaymentSheet.IntentConfiguration.Mode.Payment( amount = 1099, currency = "usd", ), paymentMethodConfigurationId = "pmc_234", // Other configuration options... ) ``` Si vous n’utilisez pas de Payment Element, transmettez l’ID `payment_method_configuration` lorsque vous [créez une session Checkout](https://docs.stripe.com/api/checkout/sessions/create.md). ```curl curl https://api.stripe.com/v1/checkout/sessions \ -u "<>:" \ -d mode=payment \ -d "line_items[0][price]={{PRICE_ID}}" \ -d "line_items[0][quantity]=1" \ --data-urlencode "success_url=https://example.com/success" \ -d currency=usd \ -d payment_method_configuration=pmc_234 ``` ### 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](https://dashboard.stripe.com/settings/payment_methods). 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](https://dashboard.stripe.com/settings/payment_methods/review) 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](https://docs.stripe.com/testing/wallets.md?ui=embedded-page). ## Créer un PaymentIntent avec la configuration Créez un PaymentIntent sur votre serveur à l’aide de la configuration du moyen de paiement. ```curl curl https://api.stripe.com/v1/payment_intents \ -u "<>:" \ -d amount=1000 \ -d currency=usd \ -d "automatic_payment_methods[enabled]=true" \ -d payment_method_configuration=pmc_123 ``` Dans la dernière version de l’API, le paramètre `automatic_payment_methods` 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_payment_method_types` lorsque vous utilisez PaymentIntents, [SetupIntents](https://docs.stripe.com/payments/setup-intents.md), [Checkout](https://docs.stripe.com/payments/checkout.md) ou [PaymentElement](https://docs.stripe.com/payments/payment-element.md). **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_payment_methods_types` avec les configurations des moyens de paiement pour contrôler la disponibilité des moyens de paiement. > Vous ne pouvez pas exclure Apple Pay, Google Pay ou Link par transaction à l’aide de `excluded_payment_method_types`. 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](https://docs.stripe.com/js/elements_object/create_payment_element#payment_element_create-options-wallets). Découvrez comment [exclure des moyens de paiement](https://docs.stripe.com/payments/payment-methods/dynamic-payment-methods.md#exclude-payment-methods).