Erstellen und Vorausfüllen des verbundenen Kontos

Verwenden Sie die Accounts v2 API, um ein verbundenes Konto zu erstellen, indem Sie das Dashboard des verbundenen Kontos und dessen Verantwortlichkeiten angeben. Als Marktplatz muss Ihre Plattform:

• Ist in der Regel der registrierte Händler.
• Verwendet indirekte Belastungen
• Verwaltet Zahlungsanfechtungen und Rückerstattungen
• Erzielt Umsätze, indem es einen Anteil an jeder Transaktion in Form von Plattformgebühren einbehält.

Diese Funktionen wirken sich auf die Parameter aus, die Sie beim Erstellen Ihrer verbundenen Konten festlegen.

Zuweisen von Kontokonfigurationen

Verbundene Konten interagieren mit Ihrer Plattform und mit Stripe auf Grundlage der Konfigurationen, die Sie ihnen zuweisen. Die meisten Marktplätze weisen ihren verbundenen Konten die Empfänger-Konfiguration zu. Einige Marktplätze vergeben zusätzlich die Händler-Konfiguration.

Die recipient-Konfiguration enthält die stripe_balance.stripe_transfers-Funktion, die es dem Stripe-Guthaben des Account ermöglicht, Transfers vom Guthaben der Plattform zu empfangen. Sie müssen die Fähigkeit stripe_balance.stripe_transfers zuweisen, um indirekte Belastungen zu verwenden.

Sie müssen Ihren verbundenen Konten außerdem in den folgenden Fällen die merchant-Konfiguration zuweisen:

• Sie verwenden Direkte Belastungen. Es ist selten, dass Marktplätze diese Art der Belastung verwenden.
• Bei indirekten Belastungen verwenden Sie den Parameter on_behalf_of, um ein verbundenes Konto als eingetragenen Händler festzulegen.

Codebeispiel

curl -X POST https://api.stripe.com/v2/core/accounts \
  -H "Authorization: Bearer 
sk_test_BQokikJOvBiI2HlWgH4olfQ2
" \
  -H "Stripe-Version: 2025-09-30.preview" \
  --json '{
    "contact_email": "testaccount@example.com",
    "display_name": "Test account",
    "defaults": {
        "responsibilities": {
            "fees_collector": "application",
            "losses_collector": "application"
        }
    },
    "dashboard": "express",
    "identity": {
        "country": "us"
    },
    "configuration": {
        "recipient": {
            "capabilities": {
                "stripe_balance": {
                    "stripe_transfers": {
                        "requested": true
                    }
                }
            }
        }
    },
    "include": [
        "configuration.recipient",
        "identity",
        "requirements"
    ]
  }'

Die Antwort enthält die ID, die Sie während Ihrer gesamten Integration zur Referenzierung des Account verwenden. Nach erfolgreicher Anfrage existiert das Konto in einem ausstehenden Zustand. Anschließend verwenden Sie die bereits vorliegenden Informationen, um das Onboarding-Formular für das verbundene Konto vorauszufüllen.

Falls Sie bereits Informationen für Ihre verbundenen Konten erfasst haben, können Sie diese im Account-Objekt vorab angeben. Sie können alle Kontoinformationen vorab ausfüllen, einschließlich persönlicher und geschäftlicher Informationen, externer Kontoinformationen usw.

Nachdem Sie ein Konto erstellt haben, erstellen Sie eine Person mit relationship.representative auf wahr, um die für die Kontoeröffnung verantwortliche Person zu vertreten und geben Sie alle Kontoinformationen an, die Sie vorausfüllen möchten (zum Beispiel Vor- und Nachname).

curl https://api.stripe.com/v1/accounts/
{{ACCOUNT_ID}}
/persons \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -d first_name=Jenny \
  -d last_name=Rosen \
  -d "relationship[representative]"=true

Connect Onboarding fragt keine vorab ausgefüllten Informationen ab. Kontoinhaber/innen müssen vorausgefüllte Informationen jedoch bestätigen, bevor sie den Connect-Rahmenvertrag akzeptieren können.

Füllen Sie beim Testen Ihrer Integration die Kontoinformationen vorab mit Testdaten aus.