Weiter zum Inhalt
Konto erstellen oder anmelden
Das Logo der Stripe-Dokumentation
/
Konto erstellenAnmelden

Verbundenes Konto erstellenÖffentliche Vorschau

Erstellen und konfigurieren Sie Ihre verbundenen Konten mithilfe der Accounts v2 API.

Wenn Sie ein verbundenes Konto zu Ihrer SaaS-Plattform hinzufügen, definiert dessen Konfiguration die Interaktionen zwischen diesem Konto, Ihrer Plattform und Stripe, einschließlich:

  • Wie die Zahlungen an die einzelnen Parteien verteilt werden
  • Welches Unternehmen zahlt Stripe-Gebühren?
  • Welches Unternehmen finanziert Rückerstattungen angefochtene Zahlungen?

Bevor Sie loslegen

Bitte befolgen Sie den Onboarding-Prozess, um Ihr Stripe-Plattformkonto einzurichten.

Dieser Leitfaden beschreibt die verschiedenen Elemente eines verbundenen Kontos, das Ihre Plattform zur Verarbeitung von Zahlungen für sein Geschäft nutzt. Das Codebeispiel am Ende dieses Leitfadens zeigt die Anfrage zum Erstellen eines verbundenen Kontos, die alle Elemente enthält. Sie können jedoch auch die Update-Methode verwenden, um die Eigenschaften des verbundenen Kontos iterativ aufzubauen.

Verbundenes Konto erstellen

Definieren Sie die Identitätseigenschaften des verbundenen Kontos, wie Name, Adresse, primäre Kontaktdaten und Unternehmenstyp. Sie können diese Angaben auch während der Onboarding-Phase von der Nutzerin/vom Nutzer des Kontos erfassen.

Zuweisen von Konfigurationen

Verbundene Konten interagieren mit Ihrer Plattform und Stripe basierend auf den von Ihnen zugewiesenen Konfigurationen. Die meisten SaaS-Plattformen weisen diese Konfigurationen zu:

  • Die Händlerkonfiguration ermöglicht es den verbundenen Konten, Kartenzahlungen von den eigenen Kundinnen und Kunden zu akzeptieren.
  • Die Kundenkonfiguration ermöglicht es den verbundenen Konten, Ihrer Plattform eine Abonnementgebühr zu entrichten, sofern Sie eine solche erheben.

Händlerfunktionen festlegen

Die Händlerkonfiguration regelt, wie Zahlungen von Kundinnen und Kunden des verbundenen Kontos in Stripe verarbeitet werden. Wenn Sie diese Konfiguration zuweisen, müssen Sie auch die folgenden Parameter angeben.

EinstellungVerhaltenWerte
DashboardWie das verbundene Konto seine Stripe-Aktivitäten und -Einstellungen anzeigt.
  • full
  • hosted
  • embedded
GebührenerhebungLegt fest, wer die Zahlungsgebühren von den verbundenen Konten einzieht.
  • stripe (Stripe erhebt Gebühren direkt)
  • Anwendung (Ihre Plattform erhebt Plattformgebühren, anschließend zieht Stripe die Gebühren von Ihrer Plattform ein)
Verantwortung für VerlusteWeist die Verantwortung für negative Salden des verbundenen Kontos zu.
  • Stripe (Stripe haftet für negative Guthaben auf verbundenen Konten)
  • Anwendung (Ihre Plattform haftet für negative Guthaben und verwaltet das Risiko für die verbundenen Konten)
Anerkennung der ZahlungsmethodeDie Zahlungsarten, wie beispielsweise Karten, Debitkarten und Wallets, die das verbundene Konto akzeptieren soll.Die Liste der verfügbaren Zahlungsmethoden finden Sie hier. Sie müssen mindestens card_payments anfordern.

Kundenfunktionen festlegen

Die Kundenkonfiguration legt fest, wie Ihre verbundenen Konten für das Abo Ihrer Plattform bezahlen, einschließlich der Frage, ob Sie Steuern von ihnen erheben und wie Sie ihnen die Rechnung stellen.

Codebeispiel

Das folgende Codebeispiel zeigt eine Anfrage zum Erstellen eines verbundenen Kontos, die die Konfigurationen für Händler, Kundinnen und Kunden und Empfänger/innen hinzufügt, wobei:

  • Stripe erhebt Gebühren und verwaltet das Risiko für Direktzahlungen auf das verbundene Konto.
  • Für das verbundene Konto sind Kartenzahlungen aktiviert.
  • Das verbundene Konto kann über das Stripe-Dashboard auf sein Konto zugreifen.
  • Sie überweisen Zahlungen auf das Guthaben des verbundenen Kontos.
  • Der include-Parameter fordert vollständige Werte in der Antwort für bestimmte Parameterobjekte an, die andernfalls standardmäßig auf „null“ gesetzt sind.
Command Line
cURL
No results
curl -X POST https://api.stripe.com/v2/core/accounts \
  -H "Authorization: Bearer 
sk_test_BQokikJOvBiI2HlWgH4olfQ2
" \
  -H "Stripe-Version: 2025-04-30.preview" \
  --json '{
    "contact_email": "furever_contact@example.com",
    "display_name": "Furever",
    "dashboard": "full",
    "identity": {
        "business_details": {
            "registered_name": "Furever"
        },
        "country": "us",
        "entity_type": "company"
    },
    "configuration": {
        "customer": {
            "capabilities": {
                "automatic_indirect_tax": {
                    "requested": true
                }
            }
        },
        "merchant": {
            "capabilities": {
                "card_payments": {
                    "requested": true
                }
            }
        },
        "recipient": {
            "capabilities": {
                "stripe_balance": {
                    "stripe_transfers": {
                        "requested": true
                    }
                }
            }
        }
    },
    "defaults": {
        "currency": "usd",
        "responsibilities": {
            "fees_collector": "stripe",
            "losses_collector": "stripe"
        },
        "locales": [
            "en-US"
        ]
    },
    "include": [
        "configuration.customer",
        "configuration.merchant",
        "identity",
        "requirements"
    ]
  }'

Nächste Schritte

Nachdem Sie Ihr verbundenes Konto erstellt und konfiguriert haben, richten Sie den Dashboard-Zugang für sie ein.

War diese Seite hilfreich?
JaNein