Mit verbundenen Konten in Treasury arbeiten
Um Stripe Treasury nutzen zu können, muss Ihre Plattform über eine Stripe Connect-Integration verfügen. Mit Stripe Connect kann eine Plattform Verkäufer/innen und Dienstleister/innen verbundene Konten bereitstellen. Einen Überblick darüber, wie verbundene Konten in die Stripe-Treasury-Kontenstruktur passen, finden Sie im Leitfaden Stripe-Treasury-Kontenstruktur.
Treasury unterstützt 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, auch als verbundenes Custom-Konto bezeichnet. Erfahren Sie, wie Sie verbundene Konten erstellen, die mit Treasury kompatibel sind.
Als Nutzer/in mit verbundenen Konten sind Sie dafür verantwortlich, eine API-Mindestversion bereitzustellen, Ihren Nutzern und Nutzerinnen Aktualisierungen der Nutzungsbedingungen mitzuteilen, Informationsanfragen Ihrer Nutzer/innen zu bearbeiten und Nutzersupport zu bieten. Da letztlich Ihre Plattform für die Verluste verantwortlich ist, die durch diese verbundenen Konten entstehen, sind Sie auch dafür verantwortlich, Ihre Nutzer/innen hinsichtlich Betrug zu überprüfen. Um mehr über Betrug zu erfahren, lesen Sie den Betrugsleitfaden für Treasury.
Notiz
Finanzkonten können nur an verbundene Custom-Konten angehängt werden.
Auf verbundenen Konten müssen bestimmte Funktionen aktiviert sein, um Features von Treasury nutzen zu können. Unterschiedliche Features erfordern unterschiedliche Funktionen, die zusätzliche Informationen zu den Inhaber/innen Ihrer verbundenen Konten notwendig machen können. Die treasury
-Funktion ist beispielsweise für verbundene Konten verpflichtend für den Treasury-Zugriff. Wenn Sie treasury
für ein Konto anfordern, werden zusätzliche Felder für dieses verbundene Konto erforderlich, bevor das Konto Treasury nutzen kann.
Bevor Sie verbundene Konten im Live-Modus für Ihre Treasury-Integration erstellen können, empfehlen wir Ihnen, zunächst verbundene Konten im Test-Modus zu erstellen. Verbundene Konten im Test-Modus können kein echtes Geld empfangen oder senden. Sie können auch nicht im Live-Modus verwendet werden, sind aber ansonsten hinsichtlich 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
Notiz
In diesem Leitfaden (der keinen Anspruch auf Vollständigkeit erhebt) wird beschrieben, wie Sie ein neues verbundenes Custom-Konto mit der Stripe API für Treasury erstellen. Eine vollständige Dokumentation zum Erstellen eines verbundenen Kontos, einschließlich durch gehostetes Onboarding, finden Sie im Connect-Integrationsleitfaden.
Verwenden Sie POST /v1/accounts
, um ein neues verbundenes Konto zu erstellen. Fordern Sie die folgenden Funktionen für das Konto an, die zur Verwendung von Stripe Treasury erforderlich sind:
transfers
(erforderlich für alle verbundenen Konten)treasury
Notiz
Sie können das Konto später aktualisieren, um diese Funktionen anzufordern, wenn Sie dies nicht beim Erstellen des Kontos tun.
Wenn Sie mit Stripe Issuing Karten für Ihr verbundenes Konto ausstellen möchten, müssen Sie auch die Funktion card_issuing
anfordern. Weitere Informationen finden Sie im Leitfaden Arbeiten mit Stripe-Issuing-Karten.
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
.
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
aufzunehmen
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
:
Verwenden Sie POST /v1/accounts/{{CONNECTED_ACCOUNT_ID}}
, um die Funktionen verbundener Konten auch für solche verbundenen Konten zu aktualisieren, denen bereits ein FinancialAccount
zugewiesen ist. Weitere Informationen finden Sie unter Arbeiten mit Finanzkonten oder in der API-Dokumentation zum FinancialAccount
-Objekt
Onboarding des verbundenen Kontos
Nach der Erstellung eines Kontos müssen Sie das Onboarding des/der Verkäufers/in bzw. Dienstleisters/in 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/die Verkäufer/in oder Dienstleister/in auf Ihrer Plattform muss die im requirements
-Hash aufgeführten Details angeben, um Zahlungen und Auszahlungen für sein/ihr verbundenes Konto zu aktivieren und alle angeforderten Funktionen seines/ihres Finanzkontos zu aktivieren.
Es gibt zwei Optionen für das Onboarding von Inhabern verbundener Konten zu Treasury: Gehostetes Onboarding und Individuelles Onboarding. Gehostetes Onboarding wird empfohlen, ist aber nicht erforderlich.
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 folgenden Anfrage wendet die erforderlichen Kontodetails mithilfe eines zuvor erstellten verbundenen Kontos an.
Gehostetes Onboarding verwenden
Verwenden Connect Onboarding, um die erforderlichen Informationen effizient zu erfassen. Dadurch werden die komplexen Vorgänge bei der Verifizierung von Ihrer Plattform an Stripe übertragen und die Bedingungen des Rahmenvertrags werden erfasst. Alternativ können Sie Ihre eigenen API-Anfragen für die anfängliche Integration erstellen und weiterhin Änderungen an den Compliance-Anforderungen überwachen, um Ihren Onboarding-Workflow auf dem neuesten Stand zu halten. Erfahren Sie, wie Sie verbundene Konten erstellen, die mit Treasury kompatibel sind.
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:
Achtung
Senden Sie Konto-Link-URLs aus Sicherheitsgründen nicht per E-Mail, Textnachricht oder anderweitig direkt an Ihre Nutzer/innen. Leiten Sie stattdessen authentifizierte Nutzer/innen von der Anwendung Ihrer Plattform an die Konto-Link-URL weiter.
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" }
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/die Inhaber/in des verbundenen Kontos die Vereinbarung für Stripe Treasury gelesen und akzeptiert hat. Unter Verifizierung mit der API handhaben finden Sie weitere Details zur Erfüllung der Onboarding-Anforderungen.
Anforderungen
Die Felder in der folgenden Tabelle müssen von Treasury-Nutzer/innen ausgefüllt werden.
Typ der juristischen Person | Beim Onboarding |
---|---|
Einzelperson, Einzelunternehmen | Angaben zum Unternehmen:
|
Unternehmen (LLCs, Corporations, gemeinnützige Organisationen, Partnerschaften usw.) | Angaben zum Unternehmen:
|
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 für die Erfassung von Informationen für Treasury aktualisieren. Das Array requirements.eventually_due
auf dem Account
-Objekt erfasst die aktualisierten Informationsanforderungen, die diese Vorschriftsänderungen benötigen. Hier erfahren Sie mehr über den Hash Requirements.