Weiter zum Inhalt
Konto erstellen
oder
anmelden
Das Logo der Stripe-Dokumentation
/
KI fragen
Konto erstellen
Anmelden
Jetzt starten
Zahlungen
Umsatz
Plattformen und Marktplätze
Geldmanagement
Entwicklerressourcen
Übersicht
Mit Connect loslegen
Integrationsgrundlagen
Musterintegrationen
Kontoverwaltung
Onboarding von Konten
    Onboarding-Konfiguration auswählen
    Kontofunktionen
      Zahlungsmethoden
    Erforderliche Verifizierungsinformationen
    Arten von Rahmenverträgen
    Zusätzliche Verifizierungen
    Vernetztes Onboarding
    Auf Stripe umsteigen
Konto-Dashboards konfigurieren
Mit verbundenen Kontotypen zusammenarbeiten
Zahlungsabwicklung
Zahlungen weltweit akzeptieren
Verbundene Konten auszahlen
Plattformverwaltung
Ihre Connect-Plattform verwalten
Steuerformulare für Ihre Connect-Plattform
StartseitePlattformen und MarktplätzeOnboard accounts

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_payments bezeichnet. Wenn Sie eine API-Version verwenden, die älter ist als die vom 14.08.2019, verwenden Sie platform_payments.

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_payments-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_payments erhält, müssen Sie sowohl card_payments 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_payments 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_reporting_us_1099_misc und tax_reporting_us_1099_kverwenden, 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_reporting_us_1099_misc können Sie die erforderlichen Informationen für das 1099-MISC-Formular erfassen. Beispielsweise könnte eine Kreativ-Plattform die Funktion tax_reporting_us_1099_misc 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_reporting_us_1099_k, 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_payments 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_behalf_of akzeptieren können, müssen Sie die Funktion dieser Zahlungsmethode für diese Konten anfordern.

Für verbundene Konten mit Zugriff auf das vollständige Stripe-Dashboard, einschließlich Standard-Konten, werden die meisten Funktionen für Zahlungsmethoden standardmäßig aktiviert. Diese Konten können ihre eigenen Funktionen für Zahlungsmethoden verwalten. Sie können auch Funktionen für sie anfordern, indem Sie die API zum Aktualisieren von Funktionen aufrufen, und die aktivierten Funktionen eines Kontos durch Aufruf der Accounts API auflisten.

In der folgenden Tabelle gibt die Spalte Alle Unternehmenstypen werden unterstützt an, dass alle Unternehmenstypen unterstützt werden, sofern nicht von Stripe untersagt. Die Spalte Zusätzliche Verifizierungsanforderungen bezieht sich auf Anforderungen zusätzlich zu denen für die Funktion card_payments.

Zahlungsmethode und zugeordnete FunktionAlle Unternehmenstypen werden unterstütztStandardmäßig verfügbarZusätzliche VerifizierungsanforderungenLänderverfügbarkeitUnterstützung von Accounts v2

ACH-Lastschriftverfahren

us_bank_account_ach_payments

Ja

Ja

Nein

Verbundenes Konto muss sich in einem unterstützten Land befinden.

Ja; Der Name der v2-Funktion lautet ach_debit_payments

Affirm

affirm_payments

Nein, siehe nicht zugelassene Unternehmen.

Ja

Nein

Verbundenes Konto muss sich in einem unterstütztem Land befinden.

Ja

Afterpay Clearpay

afterpay_clearpay_payments

Nein, siehe nicht zugelassene Unternehmen.

Ja

Nein

Verbundenes Konto muss sich in einem unterstützten Land befinden.

Ja

Alipay

alipay_payments

Nein, siehe nicht zugelassene Unternehmen.

Die Zahlungsmethode muss auf der Seite mit ihren Dashboard-Einstellungen aktiviert werden. Fordern Sie außerdem eine Einladung an, um Zahlungen für andere Konten zu erstellen.

Nein

Verbundenes Konto muss sich in einem unterstützten Land befinden.

Nein

Alma

alma_payments

No, see prohibited businesses.

Die Funktion muss auf der Seite Dashboard-Einstellungsseite aktiviert werden.

Nein

Connected account must be in a supported country.

Ja

Amazon Pay

amazon_pay_payments

Ja

Die Funktion muss auf der Seite Dashboard-Einstellungsseite aktiviert werden.

Nein

Connected account must be in a supported country.

Ja

Apple Pay

Verfügbar mit card_payments

Ja

Mit Checkout – Ja

Mit Payment Element—Die Zahlungsmethode muss auf der Dashboard-Einstellungsseite konfiguriert werden.

Nein

Verbundenes Konto muss sich in einem unterstützten Land befinden.

Ja

BACS-Lastschriftverfahren

bacs_debit_payments

Ja

Ja

Nein

Verbundenes Konto muss sich in einem unterstützten Land befinden.

Ja

Bancontact

bancontact_payments

Ja

Ja

Nein

Verbundenes Konto muss sich in einem unterstützten Land befinden.

Ja

BECS-Lastschrift

au_becs_debit_payments

Ja

Ja

Nein

Verbundenes Konto muss sich in einem unterstützten Land befinden.

Ja

Billie

billie_payments

No, see prohibited businesses.

Die Funktion muss auf der Seite Dashboard-Einstellungsseite aktiviert werden.

Nein

Connected account must be in a supported country.

Ja

BLIK

blik_payments

Ja

Die Zahlungsmethode muss auf der Seite Dashboard-Einstellungsseite aktiviert werden.

Nein

Verbundenes Konto muss sich in einem unterstütztem Land befinden.

Ja

Boleto

boleto_payments

Ja

Ja

Nein

Verbundenes Konto muss sich in einem unterstützten Land befinden.

Ja

Vorab autorisierte Lastschriftzahlungen in Kanada

acss_debit_payments

Ja

Ja

Nein

Verbundenes Konto muss sich in einem unterstützten Land befinden.

Ja

Cartes Bancaires

cartes_bancaires_payments

Ja

Ja

Nein

Verbundenes Konto muss sich in einem unterstütztem Land befinden.

Ja

Cash App Pay

cashapp_payments

Ja

Ja

Nein

Verbundenes Konto muss sich in einem unterstützten Land befinden.

Ja

EPS

eps_payments

Ja

Ja

Nein

Verbundenes Konto muss sich in einem unterstützten Land befinden.

Ja

FPX

fpx_payments

Nein, nur Unternehmen mit einer gültigen Handelsregisternummer.

Die Funktion muss auf der Seite Dashboard-Einstellungsseite aktiviert werden.

Ja

Verbundenes Konto muss sich in einem unterstützten Land befinden.

Ja

Google Pay

Verfügbar mit card_payments

Ja

Ja

Nein

Verbundenes Konto muss sich in einem unterstützten Land befinden.

Ja

GrabPay

grabpay_payments

Ja

Ja

Nein

Verbundenes Konto muss sich in einem unterstützten Land befinden.

Ja

iDEAL

ideal_payments

Ja

Ja

Ja, Steueridentifikationsnummer ist für Einzelunternehmer erforderlich.

Verbundenes Konto muss sich in einem unterstützten Land befinden.

Ja

JCB Japan

jcb_payments

Ja

Ja

Nein

Verbundenes Konto muss sich in Japan befinden.

Ja

Klarna

klarna_payments

Nein, siehe verbotene Geschäfte.

Ja

Nein

Verbundenes Konto muss sich in einem unterstütztem Land befinden.

Ja

Konbini

konbini_payments

Nein, siehe nicht zugelassene Unternehmen.

Die Zahlungsmethode muss auf der Seite Dashboard-Einstellungsseite aktiviert werden.

Nein

Verbundenes Konto muss sich in einem unterstützten Land befinden.

Ja

Link

link_payments

Ja

Ja

Nein

Verbundenes Konto muss sich in einem unterstütztem Land befinden.

Ja

MobilePay

mobilepay_payments

Nein, siehe nicht zugelassene Unternehmen.

Die Zahlungsmethode muss auf der Seite Dashboard-Einstellungsseite aktiviert werden.

Nein

Verbundenes Konto muss sich in einem unterstützten Land befinden.

Ja

Multibanco

multibanco_payments

Ja

Die Zahlungsmethode muss auf der Seite Dashboard-Einstellungsseite aktiviert werden.

Nein

Verbundenes Konto muss sich in einem unterstütztem Land befinden.

Ja

OXXO

oxxo_payments

Ja

Ja, beim ersten Zahlungsversuch.

Nein

Verbundenes Konto muss sich in einem unterstützten Land befinden.

Ja

P24

p24_payments

Ja

Ja

Nein

Verbundenes Konto muss sich in einem unterstützten Land befinden.

Ja

Pay by Bank

pay_by_bank_payments

Ja

Die Zahlungsmethode muss auf der Seite Dashboard-Einstellungsseite aktiviert werden.

Nein

Verbundenes Konto muss sich in einem unterstützten Land befinden.

Ja

PayNow

paynow_payments

Nein, siehe nicht zugelassene Unternehmen.

Ja, wenn MCC die Liste der von PayNow nicht zugelassenen Unternehmen übergibt.

Nein

Verbundenes Konto muss sich in einem unterstützten Land befinden.

Ja

Pix

pix_payments

Ja

Die Funktion muss auf der Seite Dashboard-Einstellungsseite aktiviert werden.

Nein

Verbundenes Konto muss sich in einem unterstützten Land befinden.

Nein

PromptPay

promptpay_payments

Ja

Ja

Nein

Verbundenes Konto muss sich in einem unterstützten Land befinden.

Ja

Revolut Pay

revolut_pay_payments

Ja

Die Funktion muss auf der Seite Dashboard-Einstellungsseite aktiviert werden.

Nein

Connected account must be in a supported country.

Ja

Satispay

satispay_payments

Nein, siehe nicht zugelassene Unternehmen.

Die Funktion muss auf der Seite Dashboard-Einstellungsseite aktiviert werden.

Nein

Das verbundene Konto muss sich in unterstütztem Land befinden.

Ja

SEPA-Banküberweisungen

sepa_bank_transfer_payments

Ja

Ja

Nein

Verbundenes Konto muss sich in einem unterstütztem Land befinden.

Ja

SEPA-Lastschrift

sepa_debit_payments

Ja

Ja

Ja

Verbundenes Konto muss sich in einem unterstützten Land befinden.

Ja

Sofort

sofort_payments

Ja

Ja

Nein

Verbundenes Konto muss sich in einem unterstützten Land befinden.

Nein

Stablecoin-Zahlungen

crypto_payments

Ja

Ja

Nein

Das verbundene Konto muss sich in den Vereinigte Staaten befinden.

Ja

Banküberweisungen in USD

us_bank_transfer_payments

Ja

Ja

Nein

Verbundenes Konto muss sich in einem unterstütztem Land befinden.

Ja

WeChat Pay

wechat_pay_payments

Nein, siehe nicht zugelassene Unternehmen.

Die Zahlungsmethode muss auf der Seite mit ihren Dashboard-Einstellungen aktiviert werden. Fordern Sie außerdem eine Einladung an, um Zahlungen für andere Konten zu erstellen.

Nein

Verbundenes Konto muss sich in einem unterstützten Land befinden.

Nein

Erfahren Sie mehr über unterstützte Zahlungsmethoden für Connect.

Australien
Belgien
Brasilien
Bulgarien
Dänemark
Deutschland
Estland
Finnland
Frankreich
Gibraltar
Griechenland
Hongkong
Irland
Italien
Japan
Kanada
Kroatien
Lettland
Liechtenstein
Litauen
Luxemburg
Malta
Mexiko
Neuseeland
Niederlande
Norwegen
Österreich
Polen
Portugal
Rumänien
Schweden
Schweiz
Singapur
Slowakei
Slowenien
Spanien
Thailand
Tschechische Republik
Ungarn
Vereinigte Arabische Emirate
Vereinigte Staaten
Vereinigtes Königreich
Zypern
Australien
Belgien
Brasilien
Bulgarien
Dänemark
Deutschland
Estland
Finnland
Frankreich
Gibraltar
Griechenland
Hongkong
Irland
Italien
Japan
Kanada
Kroatien
Lettland
Liechtenstein
Litauen
Luxemburg
Malaysia
Mexiko
Neuseeland
Niederlande
Norwegen
Österreich
Polen
Portugal
Rumänien
Schweden
Schweiz
Singapur
Slowakei
Spanien
Thailand
Tschechische Republik
Ungarn
Vereinigte Arabische Emirate
Vereinigte Staaten
Vereinigtes Königreich

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:

  1. Code für Transaktionszweck angeben. Das Feld export_purpose_code 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.

  2. Geben Sie Ihren Importeur-/Exporteur-Code (IEC) an. Das Feld export_license_id 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.

    • Wenn Sie Visa oder Mastercard akzeptieren möchten, ist ein IEC nur erforderlich, wenn Sie physische Waren verkaufen. Ihr export_purpose_code ist für physische Waren.
    • 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.

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_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.
Command Line
cURL
Stripe CLI
Ruby
Python
PHP
Java
Node.js
Go
.NET
No results
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:

Command Line
cURL
Stripe CLI
Ruby
Python
PHP
Java
Node.js
Go
.NET
No results
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.

Command Line
cURL
Stripe CLI
Ruby
Python
PHP
Java
Node.js
Go
.NET
No results
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:

Command Line
cURL
Stripe CLI
Ruby
Python
PHP
Java
Node.js
Go
.NET
No results
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:

Command Line
cURL
Stripe CLI
Ruby
Python
PHP
Java
Node.js
Go
.NET
No results
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.

Notiz

Sie können das Anfordern der legacy_payments-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_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.

Vor dem Anfordern neuer FunktionenNeue Funktionen angefordertNeue Anforderungen erfüllt
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

Notiz

Während des Übergangs können die Anforderungen card_payments und transfers in past_due angezeigt werden. Wenn legacy_payments jedoch aktiviert ist, bleiben Zahlungen, Überweisungen und Auszahlungen aktiviert.

Siehe auch

  • Zahlung erstellen
War diese Seite hilfreich?
JaNein
  • Benötigen Sie Hilfe? Kontaktieren Sie den Kundensupport.
  • Nehmen Sie an unserem Programm für frühzeitigen Zugriff teil.
  • Schauen Sie sich unser Änderungsprotokoll an.
  • Fragen? Sales-Team kontaktieren.
  • LLM? Lesen Sie llms.txt.
  • Unterstützt von Markdoc