ZahlungsmethodeneinstellungenPrivate Vorschau

Geben Sie die Zahlungsmethodenkonfiguration eines verbundenen Kontos wieder, um die im Bezahlvorgang angezeigten Zahlungsmethoden anpassen zu können. Verbundene Konten können ihre Zahlungsmethoden anpassen und die erforderlichen Compliance-Details für ihre Nutzung angeben.

Die eingebetteten Zahlungsmethodeneinstellungen verwenden die Payment Method Configurations API und die Account Capabilities API, um Ihren verbundenen Konten eine Liste anpassbarer Zahlungsmethoden anzuzeigen. Wenn ein verbundenes Konto vor der Anforderung der Funktion der Zahlungsmethode zusätzliche Compliance-Daten benötigt, zeigt die Komponente dies an und erfasst die erforderlichen Informationen im Voraus.

Anforderungen

Ihre Integration muss dynamische Zahlungsmethoden verwenden, um die Präferenzen des verbundenen Kontos während des Bezahlvorgangs automatisch zu übernehmen. In vorgefertigten Nutzeroberflächen für Zahlungen wie Payment Element und Checkout übernimmt Stripe die Logik für die Anzeige berechtigter Zahlungsmethoden für jede Transaktion.

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:

Komponente integrieren

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);

Steuerelemente auf Plattformebene

Die Komponente für eingebettete Zahlungsmethodeneinstellungen berücksichtigt die Standardeinstellungen auf Plattformebene, die Sie über das Dashboard oder die Payment Method Configurations API konfigurieren.

Bei Zahlungsmethoden, die Sie als Standardmäßig aktivieren oder Standardmäßig deaktivieren konfigurieren, kann das verbundene Konto diese Einstellung in der Komponente überschreiben. Wenn Sie eine Zahlungsmethode auf Blockiert gesetzt haben, ist diese in der Komponente vollständig ausgeblendet.

Mehrere Konfigurationen der Zahlungsmethoden

In den Standardeinstellungen zeigt die Komponente für eingebettete Zahlungsmethodeneinstellungen die Standardkonfiguration der Zahlungsmethode des verbundenen Kontos an. Während der Vorschau unterstützt die Komponente mehrere Konfigurationen mit dem Attribut payment-method-configuration.

Unterstützte Parameter

Diese eingebettete Komponente unterstützt die folgenden Parameter:

Frühzeitigen Zugriff anfordern Private Vorschau

Melden Sie sich an, um Zugriff auf diese eingebettete Connect-Komponente in der Vorschau anzufordern.

Wenn Sie kein Stripe-Konto haben, können Sie sich hier registrieren.