Mit verbundenen Konten arbeiten

Um Finanzkonten für Plattformen verwenden zu können, muss Ihre Plattform über eine Stripe Connect-Integration verfügen. Stripe Connect ermöglicht es einer Plattform, Verkäufern und Dienstleistern verbundene Konten zur Verfügung zu stellen. Einen Überblick darüber, wie sich verbundene Konten in die Kontostruktur von Finanzkonten für Plattformen einfügen, finden Sie im Leitfaden Kontenstruktur von Finanzkonten für Plattformen.

Finanzkonten für Plattformen unterstützen nur verbundene Konten, die kein von Stripe gehostetes Dashboard verwenden und bei denen Ihre Plattform für die Erfassung von Anforderungen und die Verlusthaftung verantwortlich ist, einschließlich verbundener Custom-Konten. Erfahren Sie, wie Sie verbundene Konten erstellen die mit Finanzkonten für Plattformen arbeiten.

Als Plattform mit verbundenen Konten sind Sie dafür verantwortlich, eine Mindest-API-Version zu pflegen, Aktualisierungen der Nutzungsbedingungen an Ihre verbundenen Konten zu kommunizieren, Informationsanfragen von ihnen zu bearbeiten und ihnen Support zu bieten. Da Ihre Plattform letztendlich für die Verluste verantwortlich ist, die Ihre verbundenen Konten erleiden, sind Sie auch dafür verantwortlich, sie auf Betrug zu überprüfen. Um mehr zu erfahren, lesen Sie den Leitfaden Finanzkonten für Plattformen – Betrug.

Für verbundene Konten müssen bestimmte Funktionen auf dem Konto aktiviert sein, um die Funktionen von Finanzkonten für Plattformen nutzen zu können. Unterschiedliche Funktionen erfordern unterschiedliche Fähigkeiten, die möglicherweise zusätzliche Informationen über die Inhaber Ihres verbundenen Kontos erfordern. Die treasury-Funktion ist beispielsweise eine Anforderung an verbundene Konten für deren Zugang zu Finanzkonten für Plattformen. Wenn Sie treasury für ein Konto anfordern, sind zusätzliche Felder für dieses verbundene Konto erforderlich, bevor das Konto die Lösung Finanzkonten für Plattformen verwenden kann.

Bevor Sie verbundene Konten im Live-Modus für die Integration Ihrer Finanzkonten für Plattformen erstellen, empfehlen wir Ihnen, zunächst verbundene Testkonten in einer sandbox-Umgebung zu erstellen. Verbundene Testkonten können kein echtes Geld empfangen oder senden und können nicht im Live-Modus verwendet werden, sind aber ansonsten in Konfiguration und Funktionalität identisch.

Arten aktueller verbundener Konten prüfen

Wenn Ihre Plattform bereits über eine Connect-Integration mit verbundenen Konten verfügt, Sie sich aber bezüglich deren Typs unsicher sind, können Sie diese Information über das Dashboard oder die API abrufen.

Erstellen Sie ein neues verbundenes Konto mit der Treasury-Funktion

Verwenden Sie POST /v1/accounts , um ein neues verbundenes Konto zu erstellen. Fordern Sie die folgenden Funktionen für das Konto an, die für die Verwendung von Finanzkonten für Plattformen erforderlich sind:

• transfers (erforderlich für alle verbundenen Konten)
• treasury

Wenn Sie Karten mit Stripe Issuing für Ihr verbundenes Konto ausstellen möchten, müssen Sie die Funktion card_issuing anfordern. Siehe den Leitfaden Arbeiten mit Karten von Stripe Issuing für weitere Informationen.

Wenn Sie ACH nutzen möchten, um Gelder von oder zu einem externen Konto zu überweisen, müssen Sie auch die Funktion us_bank_account_ach_payments anfordern.

Mit allen vorherigen Optionen sieht die Anfrage wie folgt aus:

const account = await stripe.accounts.create({
  country: 'US',
  email: email,
  capabilities: {
    transfers: {requested: true},
    treasury: {requested: true},
    card_issuing: {requested: true},
  },
  controller: {
    dashboard: {type: "none"},
    losses: {payments: "application"},
    requirement_collection: "application",
    fees: {payer: "application"}
  },
});

Bei Erfolg bestätigt die Antwort, die Sie erhalten, das verbundene Konto und die angeforderten capabilities.

{
  "id": "acct_1234",
  "object": "account",
  "capabilities": {
    "card_issuing": "inactive", // Should be requested only for Stripe Issuing users.
    "treasury": "inactive",
    "us_bank_account_ach_payments": "inactive"
  },
  ...
}

Weitere Informationen zu Funktionen für verbundene Konten finden Sie im Leitfaden Kontofunktionen für Connect.

Aktualisieren Sie ein verbundenes Konto, um die Treasury-Funktion einzubeziehen

Wenn Sie bereits ein verbundenes Konto mit aktivierten card_payments haben, verwenden Sie POST /v1/accounts/{{CONNECTED_ACCOUNT_ID}}, um das Konto mit der zugehörigen ID mit einer Anforderung für die Funktion treasury zu aktualisieren. Die folgende Anfrage aktualisiert ein verbundenes Konto mit einer Anfrage für die Funktion treasury und enthält die optionalen Funktionen card_issuing und us_bank_account_ach_payments:

curl https://api.stripe.com/v1/accounts/
{{CONNECTED_ACCOUNT_ID}} \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -d "capabilities[treasury][requested]"=true \
  -d "capabilities[card_issuing][requested]"=true \
  -d "capabilities[us_bank_account_ach_payments][requested]"=true

Verwenden Sie POST /v1/accounts/{{CONNECTED_ACCOUNT_ID}}, um die Funktionen für verbundene Konten für solche verbundene Konten zu aktualisieren, denen bereits ein FinancialAccount zugewiesen wurde. Siehe Arbeiten mit Finanzkonten oder die FinancialAccount objekt-API-Dokumentation für weitere Informationen.

Onboarding des verbundenen Kontos

Nach der Erstellung eines Kontos müssen Sie das Onboarding des Verkäufers bzw. Dienstleisters durchführen, um die Eigentumsrechte zu erhalten. Das Account-Objekt, das das verbundene Konto darstellt, hat einen requirements-Hash, der die currently_due Anforderungen an die Identitätsprüfung enthält. Der Verkäufer oder Dienstleister auf Ihrer Plattform muss die im requirements-Hash aufgeführten Details angeben, um Zahlungen und Auszahlungen für sein verbundenes Konto zu aktivieren und alle angeforderten Funktionen seines Finanzkontos zu aktivieren.

Sie haben zwei Optionen für das Onboarding von Inhabern verbundener Konten in Finanzkonten für Plattformen: gehostetes Onboarding und benutzerdefiniertes Onboarding. Wir empfehlen ein gehostetes Onboarding.

Wenn Sie ein Account-Objekt im Test-Modus erstellen und die Onboarding-Anforderungen umgehen möchten, um die Funktionalität zu testen, verwenden Sie POST /v1/accounts/{{CONNECTED_ACCOUNT_ID}}, um Testwerte bereitzustellen, die alle Anforderungen erfüllen. Die folgende Anfrage wendet die erforderlichen Kontodetails mithilfe eines zuvor erstellten verbundenen Kontos an.

curl https://api.stripe.com/v1/accounts/{{CONNECTED_ACCOUNT_ID}} \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -d "tos_acceptance[date]"=1547923073 \
  -d "tos_acceptance[ip]"="172.18.80.19" \
  -d "settings[treasury][tos_acceptance][date]"=1547923073 \
  -d "settings[treasury][tos_acceptance][ip]"="172.18.80.19" \
  -d "business_profile[mcc]"=5045 \
  --data-urlencode "business_profile[url]"="https://bestcookieco.com" \
  -d "company[address][city]"=Schenectady \
  -d "company[address][line1]"="123 State St" \
  -d "company[address][postal_code]"=12345 \
  -d "company[address][state]"=NY \
  -d "company[tax_id]"=000000000 \
  -d "company[name]"="The Best Cookie Co" \
  -d "company[phone]"=8888675309 \
  -d "individual[first_name]"=Jenny \
  -d "individual[last_name]"=Rosen

Gehostetes Onboarding verwenden

Nutzen Sie Connect Onboarding, um die erforderlichen Informationen effizient zu erfassen. Dadurch wird die Verifizierungskomplexität von Ihrer Plattform auf Stripe verlagert und die Bedingungen des Rahmenvertrags werden erfasst. Alternativ können Sie Ihre eigenen API-Anforderungen für die Erstintegration schreiben, müssen jedoch die Änderungen der Compliance-Anforderungen m Auge behalten, um Ihren Onboarding-Workflow auf dem neuesten Stand zu halten. Erfahren Sie, wie Sie verbundene Konten erstellen die mit Finanzkonten für Plattformen arbeiten.

Bevor Sie Connect Onboarding verwenden können, müssen Sie den Namen, die Farbe und das Symbol Ihrer Marke im Abschnitt Branding auf der Seite mit Ihren Connect-Einstellungen angeben. Dadurch wird das visuelle Erscheinungsbild des Formulars angepasst, mit dem Verkäufer/innen und Dienstleister/innen nach dem Onboarding auf Ihrer Plattform interagieren.

Um die Vorteile von Connect Onboarding zu nutzen, verwenden Sie POST /v1/account_links, um einen AccountLink zu erstellen, der dem/der Verkäufer/in bzw. Dienstleister/in bereitgestellt wird, der/die das verbundene Konto übernehmen wird:

curl https://api.stripe.com/v1/account_links \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -d account=
"{{CONNECTED_ACCOUNT_ID}}" \
  --data-urlencode refresh_url="https://example.com/reauth" \
  --data-urlencode return_url="https://example.com/return" \
  -d type=account_onboarding

Die Antwort, die Sie empfangen, enthält die URL, die Sie Ihrem Nutzer/Ihrer Nutzerin zur Verfügung stellen müssen.

{
  "object": "account_link",
  "created": 1612927106,
  "expires_at": 1612927406,
  "url": "https://connect.stripe.com/setup/s/iCtLfmYb2tEU"
}

Eingebettetes Onboarding verwenden

Die eingebettete Onboarding-Nutzeroberfläche weist nur wenig Stripe-Branding auf und kann an Ihre Marke angepasst werden. Sie bietet Ihnen mehr Kontrolle über das Nutzererlebnis als die gehostete Onboarding-Lösung von Stripe. Mit eingebettetem Onboarding erhalten Sie einen angepassten Onboarding-Ablauf ohne die Komplexität und den Pflegeaufwand, die mit der Aktualisierung Ihrer Onboarding-Integration bei sich ändernden Compliance-Anforderungen verbunden sind.

Ihre Plattform bettet die Konto-Onboarding-Komponente in Ihre Anwendung ein und Ihre verbundenen Konten interagieren mit der eingebetteten Komponente, ohne Ihre Anwendung zu verlassen. Das eingebettete Onboarding verwendet die Accounts API, um die Anforderungen zu lesen und ein Onboarding-Formular mit zuverlässiger Datenvalidierung zu generieren, das für alle von Stripe unterstützten Länder lokal angepasst ist.

Nutzerdefiniertes Onboarding verwenden

Wenn Sie lieber ein individuelles Onboarding für Ihre Nutzer/innen schaffen möchten, verwenden Sie POST /v1/accounts/{{CONNECTED_ACCOUNT_ID}} und POST /v1/accounts/{{CONNECTED_ACCOUNT_ID}}/persons/{{PERSON_ID}}, um die entsprechenden Account- und Person-Objekte mit den benötigten Informationen zu aktualisieren.

Sie müssen auch bestätigen, dass der Inhaber des verbundenen Kontos die Vereinbarung zu Finanzkonten für Plattformen gelesen und akzeptiert hat . Siehe Durchführung der Verifizierung mit der API für weitere Informationen zur Erfüllung der Onboarding-Anforderungen.

curl https://api.stripe.com/v1/accounts/
{{CONNECTED_ACCOUNT_ID}} \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -d "company[name]"=Homebox \
  -d "company[address][line1]"="123 Market St." \
  -d "company[address][city]"="San Francisco" \
  -d "company[address][state]"=CA \
  -d "company[address][postal_code]"=94107 \
  -d "company[address][country]"=US

Anforderungen

Die Felder in der folgenden Tabelle sind für Benutzer/innen von Finanzkonten für Plattformen erforderlich.

Abschluss

Der Onboarding-Vorgang des verbundenen Kontos ist abgeschlossen, wenn Sie den Webhook account.updated erhalten, der die folgenden Felder in Ihrem verbundenen Konto bestätigt:

{
  "object": {
    "object": "account",
    "id": "acct_1234",
    "capabilities": {
      "treasury": "active",
      "card_issuing": "active", // Only appears if requesting the `card_issuing` capability.
      "us_bank_account_ach_payments": "active", // Only appears if requesting the `us_bank_account_ach_payments` capability.
    },
    ...
  }
}

Die Latenz für das Konto-Onboarding beträgt weniger als 5 Minuten, wenn Evolve Bank & Trust der Bankpartner Ihrer Plattform ist.

Aktualisierte Anforderungen

Um sich an Änderungen der Finanzvorschriften anzupassen, muss Stripe gelegentlich die Anforderungen an die Datenerfassung für Finanzkonten für Plattformen aktualisieren. Das requirements.eventually_due -Array auf dem Account-Objekt erfasst die aktualisierten Informationen, die für diese Verordnungsänderungen erforderlich sind. Erfahren Sie mehr über den Hash requirements.