Auszahlungen und Aufladungen von Stripe Payments
Mithilfe von Auszahlungen können Sie Geld von Stripe Payments auf Stripe Treasury übertragen – und mit Aufladungen in die umgekehrte Richtung.
Finanzkonten als externe Konten
Bevor Sie Auszahlungen an ein Treasury-Finanzkonto senden oder Aufstockungen von einem Treasury-Finanzkonto erhalten können, müssen Sie das Finanzkonto als externes Konto (BankAccount
-Objekt) festlegen, das mit dem entsprechenden Stripe-Konto verbunden ist.
- Verbundene Konten: Verwenden Sie
POST /v1/accounts/{{CONNECTED_ACCOUNT_ID}}/ external_accounts
mit den Finanzkontoinformationenrouting_number
undaccount_number
, um einBankAccount
-Objekt zu erstellen, das Sie für Auszahlungen von einem verbundenen Konto verwenden können. - Plattformkonten: Verwenden Sie das Stripe-Dashboard, um ein
BankAccount
-Objekt zu erstellen, das Sie für Auszahlungen von oder Aufstockungen auf Ihr Plattformkonto verwenden können.
Wenn kein externes Standardkonto für die Währung usd
festgelegt ist, wird das Finanzkonto zum Standardauszahlungsziel des Kontos. Wenn bereits ein externes Konto als Standardkonto für usd
festgelegt ist, Sie aber möchten, dass das Finanzkonto das neue Standardkonto für ein verbundenes Konto sein soll, legen Sie default_for_currency
in Ihrem Aufruf auf true
fest (wie im folgenden Beispiel). Wenn Sie einen automatischen Auszahlungsplan aktiviert haben, ändert sich dadurch das Ziel der Auszahlungen in das Finanzkonto.
curl https://api.stripe.com/v1/accounts/{{CONNECTED_ACCOUNT_ID}}/external_accounts \ -u
: \ -d "external_account[object]"="bank_account" \ -d "external_account[routing_number]"="{{FINANCIAL_ACCOUNT_ROUTING_NUMBER}}" \ -d "external_account[account_number]"="{{FINANCIAL_ACCOUNT_ACCOUNT_NUMBER}}" \ -d "external_account[country]"="US" \ -d "external_account[currency]"="usd" \ -d "default_for_currency"="true"sk_test_4eC39HqLyjWDarjtT1zdp7dc
Bei Erfolg gibt die Antwort das neu erstellte BankAccount
-Objekt zurück.
{ "id": "{{BANK_ACCOUNT_ID}}", "object": "bank_account", "account": "{{CONNECTED_ACCOUNT_ID}}", "account_holder_name": null, "account_holder_type": null, "available_payout_methods": [ "standard", "instant" ], ... "default_for_currency": true, ... }
Auszahlungen
Payouts bewegt Geld von einem Kontoguthaben (auch als Zahlungsguthaben oder Übernahmesaldo bezeichnet) in einen Treasury-Finanzkontosaldo oder auf ein externes Bankkonto. Alle Stripe-Plattformkonten und verbundene Konten auf der Plattform verfügen über einen Kontosaldo, in dem das Geld gespeichert wird, das die Kontoinhaber/innen verdient haben (weitere Informationen zu Treasury-Kontotypen finden Sie im Leitfaden zur Kontenstruktur in Stripe Treasury). Diese Gelder sind außerhalb von Stripe erst dann zugänglich, wenn die Nutzer/innen das Geld auf das richtige Konto überweisen. Bei Verwendung von Stripe Treasury ist dieses Konto ein Finanzkonto, das Sie mit automatischen oder manuellen Auszahlungen füllen können. Weitere Informationen zu Auszahlungen mit Stripe Connect finden Sie im Leitfaden Geld auszahlen.
Automatische Auszahlungen
Wenn Sie auf Ihrer Plattform über verbundene Konten mit einem automatischen Auszahlungsplan verfügen, können Sie stattdessen das Ziel für direkte Auszahlungen von den externen Bankkonten der Nutzer/innen der verbundenen Konten in deren Finanzkonten ändern. Dazu muss das Treasury-Finanzkonto als BankAccount
-Objekt eingerichtet sein. Weitere Informationen finden Sie im Abschnitt Finanzkonten als externe Konten.
Geschwindigkeit automatischer Auszahlungen
Bei Verwendung automatischer Auszahlungen sind die Gelder aus eingehenden Kartenzahlungen standardmäßig zwei Werktage nach Zahlungseingang im Saldo des Finanzkontos verfügbar (Zeitplan T+2). Andere Zahlungsarten, z. B. ACH-Zahlungen, dauern länger.
Nach einer Kreditbewilligung auf Plattformebene können Sie für verbundene Konten schnellere T+1-Auszahlungen pro Konto ermöglichen. Sie können die Parameter interval
und delay_days
mit POST /v1/accounts
festlegen, um Auszahlungspläne automatisch zu beschleunigen (oder Sie können schnellere Auszahlungen manuell auslösen, wie unten beschrieben). Wenden Sie sich an treasury-support@stripe.com, wenn Sie Zugriff auf schnellere Auszahlungen (manuell, automatisiert oder beides) für die verbundenen Konten auf Ihrer Plattform anfordern möchten.
Die schnelleren Auszahlungspläne T+1 gelten für alle Zahlungsarten, einschließlich Kartenzahlungen und ACH-Zahlungen.
Automatischer Auszahlungsplan T+1
Damit eingehende Zahlungen am nächsten Werktag automatisch auf dem Finanzkonto verfügbar sind, senden Sie eine Anfrage, bei der interval
auf daily
und delay_days
auf 1
gesetzt ist.
Verwenden Sie POST /v1/accounts/{{CONNECTED_ACCOUNT_ID}}
, um den Auszahlungsplan zu aktualisieren.
Die Antwort bestätigt, dass die Einstellungen aktualisiert wurden.
{ ... "settings": { "payouts": { "schedule": { "interval": "daily", "delay_days": 1, }, }, ... } ... }
Manuelle Auszahlungen
Sie können manuelle Auszahlungen verwenden, um bestimmte Teile des Kontoguthabens an das Treasury-Finanzkonto dieses Kontos zu senden.
Verwenden Sie POST /v1/payouts
mit dem Bankkonto id
, das mit Ihrem Finanzkonto verbunden ist, das als Parameterwert destination
angegeben ist. Wenn Sie noch kein BankAccount
-Objekt haben, das mit Ihrem Treasury-Finanzkonto verbunden ist, finden Sie weitere Informationen im Abschnitt Finanzkonten als externe Konten.
Bei Erfolg gibt die Antwort das neu erstellte Payout
-Objekt zurück.
{ "id": "{{PAYOUT_ID}}", "object": "payout", "amount": 1000, ... "currency": "usd", "destination": "{{BANK_ACCOUNT_ID}}", ... "method": "standard", ... }
Geschwindigkeiten manueller Auszahlungen
Für manuelle Auszahlungen stehen zwei schnelle Methoden zur Verfügung – standard
und instant
.
Manuelle Auszahlungen mit der Geschwindigkeit standard
können nur das Guthaben der Option available
in Anspruch nehmen, und Gelder gehen in der Regel innerhalb eines Werktags auf dem Finanzkonto ein (Zeitplan T+1).
Wenn Ihre Plattform für schnellere Auszahlungen aktiviert ist, können Sie manuelle instant
-Auszahlungen verwenden, um Gelder innerhalb einer Stunde auf das Finanzkonto eines verbundenen Kontos zu überweisen. Sie können sofortige manuelle Auszahlungen jederzeit anfordern, auch an Wochenenden und Feiertagen. Manuelle sofortige Auszahlungen können über das instant_available
-Guthaben eines Stripe-Kontos erfolgen. Wenn Ihre Plattform nicht für schnellere Auszahlungen aktiviert ist und Sie diese Funktion hinzufügen möchten, kontaktieren Sie treasury-support@stripe.com, um die Funktion anzufordern.
Um anstelle einer standardmäßigen manuellen Auszahlung eine sofortige manuelle Auszahlung anzufordern, ändern Sie den Parameter method
in der Auszahlungsanfrage von standard
in instant
.
Auszahlungen testen
Sie können eine Auszahlung auf ein verbundenes Konto mit API-Schlüsseln im Test-Modus simulieren.
Sie können eine Auszahlung auf ein Finanzkonto für Plattformen nur über das Dashboard simulieren. Klicken Sie im Testmodus oben rechts in der Ansicht Salden Ihres Dashboards auf die Schaltfläche Geld hinzufügen, um das Dialogfeld Geld hinzufügen zu öffnen. Befolgen Sie die Anweisungen, um das Senden von Geld von Ihrem Plattformkontoguthaben an Ihr Finanzkontoguthaben zu simulieren.
Schaltfläche „Geld hinzufügen“
Aufladungen
Als Inhaber/in einer Connect-Plattform können Sie das Guthaben Ihres Treasury-Finanzkontos verwenden, um Ihr Plattformkonto aufzuladen, anstatt ein externes Bankkonto zu verwenden. Um ein Plattformkontoguthaben aufzuladen, müssen Sie das Treasury-Finanzkonto der Plattform mithilfe des Stripe-Dashboards als standardmäßiges externes BankAccount
der Plattform festlegen, wie im Leitfaden zum Hinzufügen von Geldern zu Ihrem Plattformguthaben beschrieben.
Neue BankAccount
-Objekte mit Treasury-Finanzkontodaten werden im Gegensatz zu echten externen Bankkonten bei der Erstellung automatisch verifiziert, sodass keine Verifizierung durch Testeinzahlungen erforderlich ist.
Nachdem Sie das Treasury-Finanzkonto als externes Standardbankkonto Ihrer Plattform festgelegt haben, verwenden Sie POST /v1/topups
, um die Aufladung zu erstellen.
Bei Erfolg gibt die Antwort das Top-Up
-Objekt zurück.
{ "id": "{{TOP_UP_ID}}", "object": "topup", "amount": 2000, "currency": "usd", "description": "Top-up", ... }
Erfahren Sie mehr über Guthaben zu Ihrem Plattformkonto hinzufügen mit Stripe Connect.