Paramètres des moyens de paiementVersion bêta privée

Affichez la configuration des moyens de paiement d’un compte connecté pour permettre la personnalisation des moyens de paiement affichés lors du paiement. Les comptes connectés peuvent personnaliser leurs moyens de paiement et fournir les détails de conformité nécessaires à leur utilisation.

Les paramètres des moyens de paiement intégrés utilisent les API Payment Method Configurations et Account Capabilities pour afficher une liste de moyens de paiement personnalisables à vos comptes connectés. Si un compte connecté nécessite des données de conformité supplémentaires avant de demander la fonctionnalité du moyen de paiement, le composant l’indique et collecte les informations nécessaires à l’avance.

Exigences

Votre intégration doit utiliser des moyens de paiement dynamiques pour appliquer automatiquement les préférences du compte connecté lors du paiement. Dans les interfaces utilisateur de paiement prédéfinies telles que Payment Element et Checkout, Stripe gère la logique d’affichage des moyens de paiement éligibles pour chaque transaction.

Installez une version bêta des SDK Stripe pour créer des sessions de compte avec des composants de la version bêta privée :

• Ruby >=15.3.0-beta.1
• Python >=12.3.0b1
• PHP >=17.4.0-beta.1
• Node >=18.3.0-beta.1
• .NET >=48.3.0-beta.1
• Java >=29.3.0-beta.1
• Go >=82.3.0-beta.1

Utilisez la version bêta des bibliothèques côté client de Stripe pour afficher les composants de la version bêta privée :

Intégrer le composant

Lorsque vous créez une session de compte, activez les paramètres des moyens de paiement en indiquant payment_method_settings dans le paramètre components.

curl https://api.stripe.com/v1/account_sessions \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -H "Stripe-Version: 2025-06-30.basil; embedded_connect_beta=v2;" \
  -d account=
{{CONNECTED_ACCOUNT_ID}} \
  -d "components[payment_method_settings][enabled]"=true

Après avoir créé la session du compte et initialisé ConnectJS, vous pouvez afficher le composant des paramètres des moyens de paiement dans le front-end :

// Include this element in your HTML
const paymentMethodSettings = stripeConnectInstance.create('payment-method-settings');
container.appendChild(paymentMethodSettings);

Contrôles au niveau de la plateforme

Le composant des paramètres des moyens de paiement intégrés respecte les paramètres de la plateforme par défaut que vous configurez dans le Dashboard ou dans l’API Payment Method Configurations.

Pour les moyens de paiement que vous configurez comme Activé par défaut ou Désactivé par défaut, le compte connecté peut remplacer cette préférence dans le composant. Si vous avez configuré un moyen de paiement comme étant Bloqué, il est complètement caché dans le composant.

Configurations de moyens de paiement multiples

Avec les paramètres par défaut, le composant des paramètres des moyens de paiement intégré affiche la configuration du moyen de paiement par défaut du compte connecté. Pendant la phase bêta, le composant prend en charge les configurations multiples à l’aide de l’attribut payment-method-configuration.

Paramètres pris en charge

Ce composant intégré prend en charge les paramètres suivants :

Demander un accès anticipé Private preview

Connectez-vous pour demander l’accès à ce composant intégré Connect en version bêta.

Vous pouvez créer un compte Stripe si vous n’en avez pas.