Configurations multiples sur des moyens de paiement dynamiques

Configurez plusieurs ensembles de moyens de paiement pour différents scénarios de paiement.

Les moyens de paiement dynamiques à configurations multiples vous permettent de créer plusieurs configurations de moyens de paiement, chacune comportant un ensemble de moyens de paiement activés ou désactivés. Une configuration définit les moyens de paiement disponibles pour un acheteur en fonction de l’emplacement et de la devise du paiement.

Au moment du paiement, vous pouvez sélectionner une configuration selon la logique de votre choix, que ce soit en fonction de l’emplacement de l’acheteur, des articles dans le panier, du volume de la commande ou de votre tunnel de paiement. Par exemple, vous pouvez utiliser une configuration de moyens de paiement pour votre flux d’abonnement et une autre pour votre tunnel de paiement standard. Stripe classe les moyens de paiement activés dans cette configuration de façon intelligente afin d’optimiser votre taux de conversion.

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 Gestion de la configuration, sélectionnez Ajouter une nouvelle configuration.
Nommez votre nouvelle configuration.
Cliquez sur Enregistrer la configuration.

La page affiche votre nouvelle configuration. Vous disposez alors d’un ensemble de moyens de paiement activés par défaut.

Pour naviguer entre les configurations, utilisez la liste déroulante Sélectionner une configuration en haut de la page.

Page de configuration 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 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.

Note

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_method_configuration 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',
   payment_method_configuration: 'pmc_234'
}

Si vous n’utilisez pas de Payment Element, transmettez l’ID payment_method_configuration lorsque vous créez une session Checkout.

Command Line

curl https://api.stripe.com/v1/checkout/sessions \
  -u "sk_test_VePHdqKTYQjKNInc7u56JBrQ
:" \
  -d mode=payment \
  -d "line_items[0][price]"={{PRICE_ID}} \
  -d "line_items[0][quantity]"=1 \
  --data-urlencode success_url="https://example.com/success" \
  --data-urlencode cancel_url="https://example.com/cancel" \
  -d currency=usd \
  -d payment_method_configuration=pmc_234

Pour visualiser l’affichage des moyens de paiement pour les clients, saisissez un ID de transaction ou définissez le montant et la devise d’une commande dans le Dashboard.

Créer un PaymentIntent avec la configuration

Créez un PaymentIntent sur votre serveur à l’aide de la configuration du moyen de paiement.

Command Line

curl https://api.stripe.com/v1/payment_intents \
  -u "sk_test_VePHdqKTYQjKNInc7u56JBrQ
:" \
  -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.