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.

Nachdem Sie ein Konto erstellt haben, können Sie zusätzliche Funktionen anfordern und vorhandene nicht permanente Funktionen entfernen. Für verbundene Konten, die von anderen Plattformen kontrolliert werden, können Sie die Funktionen nicht erneut anfordern.

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.

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 über transfers verfügt und der status beider Konten inactive 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 erfassen. Zum Beispiel können Sie Informationen zu Steuern und die für eine angeforderte Funktion erforderlichen Informationen gleichzeitig erfassen. Wenn Sie das Onboarding eines verbundenen Kontos mit der Funktion transfers durchführen und dieses das IRS-Formular 1099-MISC 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 für ein Konto finden Sie anhand des Endpoints list_capabilities.

Die Funktionen zum Erstellen und Anfordern von Konten unterscheiden sich für verbundene Konten mit verschiedenen Konfigurationen.

• Für verbundene Konten mit Zugriff auf das vollständige Stripe-Dashboard, einschließlich Standard-Konten, werden einige Funktionen basierend auf ihrem Land automatisch angefordert. Sie können auch andere Funktionen für sie anfordern.
• Bei verbundene 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.
• Bei verbundenen Konten ohne Zugriff auf ein von Stripe gehostetes Dashboard müssen Sie deren Funktionen anfordern. Dies gilt auch für Custom-Konten.

curl https://api.stripe.com/v1/accounts \
  -u "
sk_test_4eC39HqLyjWDarjtT1zdp7dc
:" \
  -d "controller[fees][payer]"=application \
  -d "controller[losses][payments]"=application \
  -d "controller[stripe_dashboard][type]"=none \
  -d "controller[requirement_collection]"=application \
  -d country=US \
  -d "capabilities[card_payments][requested]"=true \
  -d "capabilities[transfers][requested]"=true

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 eine Liste der Anforderungen abrufen:

curl https://api.stripe.com/v1/accounts/
{{CONNECTED_ACCOUNT_ID}} \
  -u "
sk_test_4eC39HqLyjWDarjtT1zdp7dc
:"

In der Antwort gibt der requirements-Hash die erforderlichen Informationen an. Die Werte für payouts_enabled und charges_enabled geben an, ob Auszahlungen und Gebühren für das Konto aktiviert sind.

Funktionen für bestehende verbundene Konten

In den folgenden Abschnitten wird beschrieben, wie Sie mithilfe der Capabilities API eine Vorschau der Informationsanforderungen anzeigen oder Funktionen für vorhandene verbundene Konten verwalten können.

Informationsanforderungen vorab ansehen

Sie können vorab ansehen, welche Informationen von Ihrem verbundenen Konto 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 ausgelöst, und die Anforderungen des Kontos können sich ändern. Um eine Anforderung schneller zu aktivieren und zu vermeiden, dass das Konto deaktiviert wird, sehen Sie sich eine Vorschau der Anforderungen an und erfassen alle erforderlichen Informationen, bevor Sie die Funktion anfordern.

Im folgenden Beispiel werden die Anforderungen für die card_payments-Funktion für ein bestimmtes Konto aufgeführt.

curl https://api.stripe.com/v1/accounts/
{{CONNECTED_ACCOUNT_ID}}
/capabilities/card_payments \
  -u "
sk_test_4eC39HqLyjWDarjtT1zdp7dc
:"

Überprüfen Sie den Hash requirements in der Antwort, um zu sehen, welche Informationen erforderlich sind:

{
  "id": "card_payments",
  "object": "capability",
  "account": 
"{{CONNECTED_ACCOUNT_ID}}",
  "requested": false,
  "requested_at": null,
  "requirements": {
    "past_due": [],
    "currently_due": ["company.tax_id", ...],
    "eventually_due": [...],
    "disabled_reason": ...,
    "current_deadline": ...,
  },
  "status": "unrequested"
}

Der Wert für den status gibt an, ob die Funktion angefordert wurde. Wenn der Wert angefordert wird, sind die Anforderungen für das Konto aktiviert.

Neben der Vorschau der Anforderungen einer Funktion vor der Anforderung können Sie denselben Endpoint auch verwenden, um die aktuellen Anforderungen einer Funktion anzusehen. Damit bleiben Sie über etwaige Änderungen der Anforderungen informiert.

Funktionen anfordern und Anforderungen rückgängig machen

Um eine Funktion für ein Konto 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.

Wenn Sie die Anforderung einer Funktion für ein Konto 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:

curl https://api.stripe.com/v1/accounts/
{{CONNECTED_ACCOUNT_ID}}
/capabilities/transfers \
  -u "
sk_test_4eC39HqLyjWDarjtT1zdp7dc
:" \
  -d requested=true

Im folgenden Beispiel werden mehrere Funktionen für ein bestimmtes verbundenes Konto angefordert:

curl https://api.stripe.com/v1/accounts/
{{CONNECTED_ACCOUNT_ID}} \
  -u "
sk_test_4eC39HqLyjWDarjtT1zdp7dc
:" \
  -d "capabilities[bancontact_payments][requested]"=true \
  -d "capabilities[eps_payments][requested]"=true \
  -d "capabilities[ideal_payments][requested]"=true \
  -d "capabilities[p24_payments][requested]"=true \
  -d "capabilities[sepa_debit_payments][requested]"=true