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.

Install a beta version of the Stripe SDKs to create account sessions for private preview components:

• 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

Use the beta version of the Stripe’s client-side libraries to render private preview components:

Intégrer le composant

When creating an Account Session, enable payment method settings by specifying payment_method_settings in the components parameter.

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

After creating the account session and initializing ConnectJS, you can render the payment method settings component in the frontend:

// 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.