Kontofunktionen
Erfahren Sie mehr über die Funktionen, die Sie für Konten aktivieren können, und die Voraussetzungen, die Sie erfüllen müssen, um sie zu nutzen.
Funktionen sind Funktionalitäten, die Sie für Ihre verbundenen Konten anfordern können, z. B. Akzeptieren von Kartenzahlungen oder Empfangen von Geldtransfers von Ihrem Plattformkonto. Eine Funktion muss aktiv sein, damit ein verbundenes Konto Aktionen ausführen kann, die mit dieser Funktion verknüpft sind.
Testfunktionen
Sandboxes and test mode might not enforce some capabilities. In certain cases, they can allow an account to perform capability-dependent actions even when the associated capability’s status
isn’t active
.
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.
Notiz
Einige 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.
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.
Überweisungen
Sie können Gelder an verbundene Konten überweisen, die über die Funktion transfers
verfügen. On-Demand-Plattformen verwenden diese Funktion häufig, um Zahlungen an ihre verbundenen Konten zu senden. Zum Beispiel könnte eine Fahrdienst-Plattform diese Funktion nutzen, um ihre Fahrer/innen zu bezahlen. Das folgende Diagramm veranschaulicht die Geldbewegung und die Beziehung zwischen den Kundinnen/Kunden, der Plattform und dem verbundenen Konto.
Beziehung zwischen den Kundinnen/Kunden, der Plattform und den verbundenen Konten.
Wenn Sie die transfers
-Funktion nutzen, verarbeitet Ihre Plattform die Gebühren – nicht das verbundene Konto. In den Kontoauszügen der Kundinnen/Kunden eines verbundenen Kontos wird daher die Zahlungsbeschreibung in der Abrechnung Ihrer Plattform angezeigt und nicht die des verbundenen Kontos.
Zahlungen mit der transfers
-Funktion umfassen Destination Charges und separate Zahlungen und Überweisungen.
Notiz
Vor der API-Version vom 14.08.2019 wurde die Funktion transfers
als platform_
bezeichnet. Wenn Sie eine API-Version verwenden, die älter ist als die vom 14.08.2019, verwenden Sie platform_
.
Grenzüberschreitende Überweisungen
Für Geldbewegungen über Ländergrenzen hinweg gelten zusätzliche Voraussetzungen. Sie werden nur in folgenden Szenarien unterstützt:
- Plattformen der Europäischen Union, des Vereinigten Königreichs und Gibraltars senden Gelder an SEPA-Länder.
- US-Plattformen senden Gelder an grenzüberschreitende Auszahlungsziele unter Verwendung eines Empfänger-Rahmenvertrags.
Für andere Szenarien erstellen Sie ein Plattformkonto in derselben Region wie Ihre verbundenen Konten. Je nach Geschäftsstruktur könnte dies die Erstellung einer juristischen Person in dieser Region sowie zusätzlichen Aufwand für das Onboarding verbundener Konten erfordern.
Kartenzahlungen
Verbundene Konten mit der card_
-Funktion können sowohl Zahlungen von Ihrer Plattform empfangen als auch Kartenzahlungen und ACH-Zahlungen direkt abwickeln. Ein Online-Shop mit dieser Funktion kann beispielsweise eigene Zahlungen einziehen. Im folgenden Diagramm werden die Geldbewegung und die Beziehung zwischen den Kundinnen/Kunden, den verbundenen Konten und der Plattform veranschaulicht:
Beziehung zwischen den Kundinnen/Kunden, verbundenen Konten und der Plattform.
Damit ein Konto die Funktion card_
erhält, müssen Sie sowohl card_
als auch transfers
anfordern.
Wenn ein verbundenes Konto über diese Funktion verfügt, werden auf den Kontoauszügen der Kundinnen/Kunden die Zahlungsbeschreibung in der Abrechnung des verbundenen Kontos und nicht die der Plattform angezeigt.
Die Funktion card_
gilt für alle Gebührentypen.
US-Steuerberichterstattung
Die Bundessteuerbehörde der Vereinigten Staaten (IRS) verlangt, dass einige Plattformen zwischen Januar und März das 1099-Formular abgeben und bis zum 31. Januar ihren verbundenen Konten Berichte über diese Abgaben übermitteln. Um die Formulare abgeben zu können, müssen diese Plattformen zusätzliche Informationen von ihren verbundenen Konten erfassen.
Notiz
Stripe empfiehlt, sich rechtlich beraten zu lassen, um Ihre Anforderungen für die Steuereinreichung und -berichterstattung zu ermitteln.
Wenn Ihre Plattform nach US-Bundesrecht zur Abgabe des 1099-Formulars verpflichtet ist und Sie sich für eine Abgabe über Stripe entscheiden, können Sie die Funktionen tax_
und tax_
verwenden, um die erforderlichen personenbezogenen Daten und geschäftlichen Informationen von Ihren verbundenen Konten zu erfassen.
1099-MISC-Formular
Für viele Arten von Zahlungen ist das IRS-Formular 1099-MISC erforderlich. Dazu zählen beispielsweise Zahlungen an betriebsfremde Arbeitnehmer/innen oder Auftragnehmer/innen, Lizenzgebühren, Prämien usw. Mit der Funktion tax_
können Sie die erforderlichen Informationen für das 1099-MISC-Formular erfassen. Beispielsweise könnte eine Kreativ-Plattform die Funktion tax_
nutzen, um von den Inhaltsanbietern die erforderlichen Informationen für die Steuerberichterstattung zu erfassen.
1099-K-Formular
Mit dem 1099-K-Formular werden Zahlungen gemeldet, die über Kreditkartentransaktionen oder Zahlungsnetzwerke Dritter empfangen wurden. Ursprünglich wurde das 1099-K-Formular von Drittabwicklern genutzt, um ihre Bruttoentgelt-Transaktionen im Laufe eines Kalenderjahres anzugeben. So nutzten zum Beispiel E-Commerce-Plattformen die Funktion tax_
, um die erforderlichen Informationen zur Steuerberichterstattung für jeden Online-Shop zu erfassen.
Weitere Details zu Steuererklärungen für verbundene Konten in den USA finden Sie unter Steuerformulare verwalten.
Zahlungsmethoden
Einige Zahlungsmethoden werden durch die Funktion card_
aktiviert, während andere durch ihre eigenen Funktionen aktiviert werden.
Wenn Sie erst belasten und dann auszahlen, sehen Sie in Ihrem Dashboard nach, welche Zahlungsmethoden Sie verwenden können.
Damit verbundene Konten eine Zahlungsmethode für Direct Charges oder Abbuchungen mit on_
akzeptieren können, müssen Sie die Funktion dieser Zahlungsmethode für diese Konten anfordern.
Erfahren Sie mehr über unterstützte Zahlungsmethoden für Connect.
Internationale Zahlungen in Indien
Sie müssen die Möglichkeit beantragen, Transaktionen von Käufer/innen außerhalb Indiens zu unterstützen, die eine andere Währung als INR verwenden, und während des Onboarding-Prozesses die folgenden Schritte ausführen, um internationale Zahlungen zu ermöglichen:
Code für Transaktionszweck angeben. Das Feld
export_
beschreibt die Art einer in einer Fremdwährung erhaltenen Zahlung. Die vollständige Liste der Transaktionszweckcodes wird von der Reserve Bank of India (RBI) gepflegt. Sie finden den Teil der von Stripe unterstützten Transaktionszweckcodes in der Liste der Transaktionszweckcodes.purpose_ code Geben Sie Ihren Importeur-/Exporteur-Code (IEC) an. Das Feld
export_
enthält den Wert für den IEC-Code. Dieser Code wird vom indischen Director General of Foreign Trade (DGFT) für Indien ausgestellt. Sie können einen IEC auf der DGFT-Website beantragen. Ein IEC ist unter bestimmten Bedingungen erforderlich.license_ id - Wenn Sie Visa oder Mastercard akzeptieren möchten, ist ein IEC nur erforderlich, wenn Sie physische Waren verkaufen. Ihr
export_
ist für physische Waren.purpose_ code - Wenn Sie internationale AMEX-Zahlungen für alle Exporttransaktionen akzeptieren möchten, einschließlich des Verkaufs physischer Waren und Dienstleistungen. Dies ist in der indischen Außenhandelsrichtlinie beschrieben.
- Wenn Sie Visa oder Mastercard akzeptieren möchten, ist ein IEC nur erforderlich, wenn Sie physische Waren verkaufen. Ihr
Weitere Informationen finden Sie unter Internationale Zahlungen aus Indien annehmen
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_
als auch überpayments transfers
verfügt und derstatus
beider Konteninactive
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.
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:
In der Antwort gibt der requirements
-Hash die erforderlichen Informationen an. Die Werte für payouts_
und charges_
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.
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_
-Funktion für ein bestimmtes Konto aufgeführt.
Ü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 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:
Im folgenden Beispiel werden mehrere Funktionen für ein bestimmtes verbundenes Konto angefordert:
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_
-Funktion ermöglicht Zahlungen, Auszahlungen und Überweisungen. Neuere Konten aktivieren diese Aktionen mithilfe der Funktionen card_
und transfers
, die flexiblere Konfigurationen unterstützen.
Wir empfehlen Ihnen, die folgenden Schritte durchzuführen:
Aktualisieren Sie den Onboarding-Prozess für verbundene Konten, um die entsprechende Kombination aus
card_
undpayments transfers
anstelle vonlegacy_
anzufordern.payments Aktualisieren Sie Ihre bestehenden verbundenen Konten, um die entsprechende Kombination aus
card_
undpayments transfers
anzufordern.Aktualisieren Sie jeden Code, der den Status von
legacy_
prüft, um den Status vonpayments legacy_
oder der entsprechenden neuen Funktion zu überprüfen. Aktualisieren Sie beispielsweise Code, der davon abhängt, dass ein Konto Kartenzahlungen durchführen kann, wenn entwederpayments legacy_
oderpayments card_
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 entwederpayments legacy_
oderpayments 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.Sobald die neuen Funktionen für alle Ihre verbundenen Konten aktiv sind, entfernen Sie Verweise auf
legacy_
aus Ihrem Code.payments
Notiz
Sie können das Anfordern der legacy_
-Funktion nicht rückgängig machen. Stripe benachrichtigt Sie im Voraus, bevor wir sie entfernen.
Wenn Sie in Kanada geschäftlich tätig sind, fordert Stripe automatisch card_
und transfers
für Ihre Konten an, die legacy_
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.
Vor dem Anfordern neuer Funktionen | Neue Funktionen angefordert | Neue Anforderungen erfüllt |
---|---|---|
|
|
|
Notiz
Während des Übergangs können die Anforderungen card_
und transfers
in past_
angezeigt werden. Wenn legacy_
jedoch aktiviert ist, bleiben Zahlungen, Überweisungen und Auszahlungen aktiviert.