Kontofunktionen
Die Funktionen, die Sie für ein verbundenes Konto anfordern, bestimmen die Informationen, die für dieses Konto zu erfassen sind. Um den Aufwand beim Onboarding zu reduzieren, sollten Sie nur die Funktionen anfordern, die Sie benötigen. Je mehr Funktionen Sie anfordern, um so mehr Informationen müssen Sie erfassen.
Vervollständigen Sie zunächst das Plattform-Profil, um zu verstehen, welche Funktionen sich für Ihre Plattform eignen könnten.
Notiz
Die meisten Funktionen, die Sie anfordern, werden dauerhaft aktiviert. Wenn Sie versuchen, eine permanente Funktion zu entfernen oder eine Anforderung rückgängig zu machen, erhalten Sie eine Fehlermeldung.
Unterstützte Funktionen
Im Folgenden finden Sie eine Liste der verfügbaren Funktionen. Klicken Sie auf die einzelnen Elemente, um mehr oder weniger Informationen zu diesem anzuzeigen.
Überweisungen
Kartenzahlungen
US-Steuerberichterstattung
Zahlungsmethoden
Internationale Zahlungen in Indien
Mehrere Funktionen
Es ist gängige Praxis, mehrere Funktionen für ein verbundenes Konto anzufordern. Sie sollten dabei jedoch Folgendes beachten:
- Die Funktionen sind unabhängig voneinander aktiv.
- Wenn ein verbundenes Konto sowohl über
card_payments
als auch übertransfers
verfügt und derstatus
beider Konteninactive
ist, sind beide Funktionen deaktiviert. - Sie können für ein verbundenes Konto jederzeit während der Nutzungszeit des Kontos eine beliebige Funktion anfordern bzw. die Anforderung rückgängig machen.
Darüber hinaus lassen sich mit Funktonen Informationen für mehrere Zwecke gleichzeitig sammeln, sodass Nutzer/innen dieselben Informationen nicht mehrmals übermitteln müssen. Zum Beispiel können Sie Informationen zu Steuern und die für eine angeforderte Funktion erforderlichen Informationen gleichzeitig erfassen. Wenn Sie das Nutzer-Onboarding mit der Funktion transfers
durchführen und diese das IRS-1099-MISC-Formular abgeben müssen (ein Formular für die Steuerberichterstattung auf US-Bundesebene), können Sie beide Informationen gleichzeitig erfassen.
Konto mit Funktionen erstellen
Funktionen werden im Account-Objekt festgelegt. Die Liste verfügbarer Funktionen finden Sie anhand des Endpoints list_capabilities.
Die Funktionen zum Erstellen und Anfordern von Konten unterscheiden sich für verbundene Konten mit verschiedenen Konfigurationen.
- Funktionen werden automatisch für alle Konten angefordert, denen Sie bei der Einrichtung Zugriff auf das gesamte Stripe-Dashboard gewährt haben. Dies gilt auch für Standard-Konten.
- Bei Konten mit Zugriff auf das Express-Dashboard, einschließlich Express-Konten, können Sie Funktionen entweder beim Erstellen des Kontos anfordern oder die angeforderten Funktionen über die Onboarding-Konfigurationseinstellungen automatisieren.
- Sie müssen Funktionen anfordern, wenn Sie verbundene Konten erstellen und diesen keinen Zugriff auf ein von Stripe gehostetes Dashboard gewähren. Dies gilt auch für Custom-Konten.
Die Informationsanforderungen unterscheiden sich je nach Funktion. Sie beziehen sich jedoch häufig auf die Identitätsprüfung oder andere Informationen, die einen bestimmten Zahlungstyp betreffen.
Wenn Ihr verbundenes Konto erfolgreich erstellt wurde, können Sie die Anforderungen des Kontos abrufen:
Überprüfen Sie den Hash requirements
in der Antwort, um zu sehen, welche Informationen erforderlich sind. Die Werte für payouts_enabled
und charges_enabled
geben an, ob Auszahlungen und Abbuchungen für das Konto erfolgen können.
Mehr über Funktionen
Die Grundlagen der Kontoerstellung wurden oben bereits beschrieben. Es gibt aber auch Fälle, in denen Sie Informationsanforderungen vorab ansehen oder Funktionen auf bestehenden Konten verwalten möchten. In den folgenden Abschnitten erfahren Sie, wie Sie dies mithilfe der Capabilities API tun können.
Informationsanforderungen vorab ansehen
Sie können vorab ansehen, welche Informationen von Ihren Nutzer/innen für eine bestimmte Funktion entweder vor oder nach der Anforderung der Funktion benötigt werden.
Wenn Sie Funktionen anfordern, werden die Webhooks account.updated
aktiviert, und die Anforderungen eines Kontos können sich ändern. Wenn Sie zuerst die Anforderungen vorab ansehen, die erforderlichen Informationen erfassen und dann die Funktion anfordern, können Sie Abbuchungen und Auszahlungen für das Konto schneller aktivieren. Außerdem wird so eine mögliche Deaktivierung des Kontos vermieden, da die Informationen bereits vorab erfasst wurden.
Im folgenden Beispiel werden die Anforderungen für die Funktion card_payments
für ein bestimmtes Konto abgerufen.
Überprüfen Sie den Hash requirements
in der Antwort, um zu sehen, welche Informationen erforderlich sind:
{ "id": "card_payments", "object": "capability", "account":
, "requested": false, "requested_at": null, "requirements": { "past_due": [], "currently_due": ["company.tax_id", ...], "eventually_due": [...], "disabled_reason": ..., "current_deadline": ..., }, "status": "unrequested" }"{{CONNECTED_ACCOUNT_ID}}"
Der Wert für status
gibt an, ob die Funktion den Status requested
hat. Wenn die Funktion angefordert ist, sind die Anforderungen für das Konto aktiviert.
In diesen Schritten wird beschrieben, wie Sie die Anforderungen einer Funktion vorab ansehen können, bevor die Funktion angefordert wird. Sie können denselben Endpoint jedoch auch verwenden, um die aktuellen Anforderungen für eine Funktion anzusehen. Damit bleiben Sie über die Anforderungen einer Funktion sowie etwaige Änderungen der Anforderung informiert.
Funktionen anfordern und Anforderungen rückgängig machen
Nachdem Sie die meisten Konten erstellt haben, können Sie zusätzliche Funktionen anfordern und vorhandene Funktionen entfernen. Um eine Funktion anzufordern, setzen Sie den requested
Wert der Funktion auf true
, indem Sie das Konto aktualisieren. Wenn die Anfrage erfolgreich ist, gibt die API requested: true
in der Antwort zurück. Sie können keine Funktionen für verbundene Konten mit Zugriff auf das vollständige Stripe-Dashboard anfordern, dies gilt auch für Standard-Konten.
Wenn Sie die Anforderung einer Funktion rückgängig machen möchten, legen Sie den Wert der Funktion requested
auf false
fest, indem Sie das Konto aktualisieren. Kann die Funktion nicht entfernt werden, gibt der Aufruf einen Fehler zurück. Ist der Aufruf hingegen erfolgreich, so gibt die API requested: false
in der Antwort zurück.
Sie können die Funktionen eines Kontos auch über das Dashboard anfordern und entfernen. Wenn eine Funktion nicht entfernt werden kann, ist die zugehörige Schaltfläche Entfernen deaktiviert.
Im folgenden Beispiel wird die Funktion transfers
für ein bestimmtes verbundenes Konto angefordert:
Im folgenden Beispiel werden mehrere Funktionen für ein bestimmtes verbundenes Konto angefordert: