Kontofunktionen

„Funktionen“ stellen eine Funktionalität dar, die Sie für Ihre verbundenen Konten anfordern können, wie z. B. das Akzeptieren von Kartenzahlungen oder das Empfangen von übertragenen Geldern von Ihrem Plattformkonto.

Bei den meisten Funktionen ist die Verifizierung bestimmter Informationen über das Unternehmen des verbundenen Kontos erforderlich, bevor Stripe sie für dieses Konto freischaltet. 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. Wenn weitere Funktionen angefordert werden, müssen beim Onboarding-Ablauf weitere Informationen überprüft werden.

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 die meisten Funktionen für ein verbundenes Konto jederzeit während der Nutzungszeit des Kontos anfordern bzw. die Anforderung rückgängig machen.

Darüber hinaus können Sie mit Funktonen Informationen für mehrere Zwecke gleichzeitig sammeln. Sie können beispielsweise sowohl erforderliche Steuerinformationen als auch die für eine angeforderte Funktion erforderlichen Informationen erfassen.

Funktionen für ein Konto anfordern

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_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -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_BQokikJOvBiI2HlWgH4olfQ2
:"

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 einsehen

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_BQokikJOvBiI2HlWgH4olfQ2
:"

Ü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_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -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_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -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

Veraltete Funktionen

Die in den folgenden Abschnitten beschriebenen Funktionen sind veraltet. Fordern Sie nach Möglichkeit keine neuen Konten an. Wenn Sie bestehende Konten haben, die veraltete Funktionen verwenden, empfehlen wir Ihnen, diese zu aktualisieren, um stattdessen andere Funktionen zu verwenden.

legacy_payments

Die legacy_payments-Funktion ermöglicht Zahlungen, Auszahlungen und Überweisungen. Neuere Konten aktivieren diese Aktionen mithilfe der Funktionen card_payments und transfers, die flexiblere Konfigurationen unterstützen.

Wir empfehlen Ihnen, die folgenden Schritte durchzuführen:

1. Aktualisieren Sie den Onboarding-Prozess für verbundene Konten, um die entsprechende Kombination aus card_payments und transfers anstelle von legacy_payments anzufordern.

2. Aktualisieren Sie Ihre bestehenden verbundenen Konten, um die entsprechende Kombination aus card_payments und transfers anzufordern.

3. Aktualisieren Sie jeden Code, der den Status von legacy_payments prüft, um den Status von legacy_payments oder der entsprechenden neuen Funktion zu überprüfen. Aktualisieren Sie beispielsweise Code, der davon abhängt, dass ein Konto Kartenzahlungen durchführen kann, wenn entweder legacy_payments oder card_payments aktiv ist. Aktualisieren Sie auf ähnliche Weise Code, der auf der Fähigkeit eines Kontos beruht, Überweisungen zu akzeptieren, damit er ausgeführt wird, wenn entweder legacy_payments oder transfers aktiv ist. Der aktualisierte Code funktioniert während des gesamten Prozesses der Umstellung auf die neuen Funktionen, unabhängig davon, wann die neuen Funktionen aktiv werden.

4. Sobald die neuen Funktionen für alle Ihre verbundenen Konten aktiv sind, entfernen Sie Verweise auf legacy_payments aus Ihrem Code.

Wenn Sie in Kanada geschäftlich tätig sind, fordert Stripe automatisch card_payments und transfers für Ihre Konten an, die legacy_payments verwenden, um die aktualisierten Anforderungen zu erfüllen. Während des Vorgangs werden in den API-Antworten Ihrer verbundenen Konten möglicherweise die folgenden Werte angezeigt.

capabilities: {
  legacy_payments: "active"
},
charges_enabled: true,
payouts_enabled: true

capabilities: {
  card_payments: "inactive",
  legacy_payments: "active",
  transfers: "inactive"
},
charges_enabled: true,
payouts_enabled: true

capabilities: {
  card_payments: "active",
  legacy_payments: "active",
  transfers: "active"
},
charges_enabled: true,
payouts_enabled: true