# Kontrolle über Bank- und Debitkartenüberweisungen Stripe ermöglicht Plattformen die vollständige Kontrolle über die Überweisungen für seine Custom Connect-Konten. > Auf dieser Seite wird eine ältere Version der Auszahlungen für verbundene Konten beschrieben. Wenn Ihre Integration diese Version noch nicht verwendet, finden Sie weitere Informationen unter [Auszahlungen an verbundene Konten](https://docs.stripe.com/connect/payouts-connected-accounts.md). Dieser Leitfaden gilt ausschließlich für *Custom*-Konten, bei denen Sie für die gesamte Kommunikation und Interaktion mit dem/der Kontoinhaber/in verantwortlich sind. Wenn Sie eine Verbindung zu einem bestehenden Stripe-Konto herstellen oder Stripe Aktionen wie die Erfassung von Identitätsnachweisen abwickeln lassen möchten, finden Sie weitere Informationen unter [Standard-Konten](https://docs.stripe.com/connect/standard-accounts.md). Standardmäßig werden alle Zahlungen, die Sie im Namen eines verbundenen Kontos vornehmen, im [Stripe-Saldo](https://docs.stripe.com/connect/account-balances.md) des verbundenen Kontos akkumuliert und täglich auf fortlaufender Basis ausgezahlt. Für Custom-Konten bietet Stripe jedoch eine fein abgestufte Kontrolle über dieses Verhalten. Sie können: - Zielseitige [Bankkonten und Debitkarten](https://docs.stripe.com/connect/legacy-transfers.md#bank-accounts) festlegen - Steuern, [wie oft](https://docs.stripe.com/connect/legacy-transfers.md#payout-information) Gelder automatisch ausgezahlt werden - [Manuelle Überweisungen](https://docs.stripe.com/connect/legacy-transfers.md#using-manual-transfers) durchführen - Gelder [sofort](https://docs.stripe.com/connect/legacy-transfers.md#instant-payouts) senden ## Bankkonten und Debitkarten verwalten Custom-Konten verfügen über die Eigenschaft `external_accounts`: eine Liste aller Bankkonten und Debitkarten, die mit dem Stripe-Konto verbunden sind. Jedes externe Konto ist ein mögliches Ziel für Gelder. ```json { "id": ""{{CONNECTED_ACCOUNT_ID}}"", "object": "account", "external_accounts": { "object": "list", "has_more": false, "url": "/v1/accounts/acct_14qyt6Alijdnw0EA/external_accounts", "data": [ { "id": ""{{BANK_ACCOUNT_ID}}"", "object": "bank_account", "account": "acct_14qyt6Alijdnw0EA", "account_holder_name": "Jane Austen", "account_holder_type": "individual", "bank_name": "STRIPE TEST BANK", "country": "US", "currency": "usd", "default_for_currency": false, "fingerprint": "sSZ2yLp0EZTH17cF", "last4": "6789", "metadata": { }, "routing_number": "110000000", "status": "new" }, {...}, {...}, ], ... } ``` Beim [Erstellen](https://docs.stripe.com/connect/custom-accounts.md#create) oder [Aktualisieren](https://docs.stripe.com/connect/updating-service-agreements.md) von Stripe-Konten werden Zielkonten über den Parameter `external_accounts` hinzugefügt. Der Wert sollte ein von [Stripe.js](https://docs.stripe.com/js.md) zurückgegebenes Bankkonto- oder Debitkarten-Token sein. Alternativ können Sie auch einen Hash der Bankkontodaten angeben. Stripe.js ist jedoch vorzuziehen, da damit verhindert wird, dass sensible Daten auf Ihren Server gelangen. Bei Verwendung von Debitkarten als Überweisungsziel gelten die folgenden Einschränkungen: - Es darf sich nicht um US-amerikanische Prepaid-Karten (Visa, Mastercard oder Discover) handeln - Begrenzt auf 9.999,00 USD pro Überweisung mit [Instant Payouts](https://docs.stripe.com/connect/legacy-transfers.md#instant-payouts) - Ansonsten in der Regel auf 3.000,00 USD pro Überweisung begrenzt ## Mehrere Bankkonten und Debitkarten verwalten Standardmäßig wird bei der Aktualisierung eines Custom-Kontos durch die Angabe eines neuen Werts für `external_accounts` das bestehende Konto durch das neue Konto *ersetzt*. Um weitere Bankkonten oder Debitkarten zu einem verbundenen Konto *hinzuzufügen*, verwenden Sie die API-Endpoints zum Erstellen von [Bankkonten](https://docs.stripe.com/api.md#account_create_bank_account) und [Karten](https://docs.stripe.com/api.md#account_create_card). ```curl curl https://api.stripe.com/v1/accounts/{{CONNECTEDACCOUNT_ID}}/external_accounts \ -u "<>:" \ -d "external_account={{BANKACCOUNTTOKEN_ID}}" ``` Bei der Arbeit mit mehreren Währungen sendet Stripe Überweisungen automatisch an ein zugehöriges Bankkonto oder eine Debitkarte für die jeweilige Währung. Dadurch werden Wechselkursgebühren vermieden. Wenn mehrere Konten für eine bestimmte Währung vorhanden sind, verwendet Stripe diejenige, die als `default_for_currency` festgelegt ist. Stripe führt eine Liste [verfügbarer Länder-/Währungskombinationen](https://docs.stripe.com/connect/payouts-connected-accounts.md), die Ihnen als Referenz dient und Ihren Nutzern und Nutzerinnen die Auswahl der unterstützten Optionen erleichtert. ## Auszahlungsinformationen Bei Verwendung von automatischen Auszahlungen gibt die Eigenschaft `transfer_schedule` in einem Konto an, wie häufig das Guthaben eines Stripe-Kontos automatisch ausgezahlt wird: ```json { ... "transfer_schedule": { "delay_days": 7, "interval": "daily" }, ... } ``` Die Eigenschaft `delay_days` gibt an, wie lange es dauert, bis Abbuchungen (oder verknüpfte Überweisungen) für eine Auszahlung zur Verfügung stehen. Dieses Feld ist nützlich, um automatische Auszahlungen zu steuern. Wenn Sie beispielsweise möchten, dass Ihre Custom-Konten ihre Gelder 2 Wochen nach der Abbuchung erhalten, setzen Sie `interval` auf `daily` und `delay_days` auf **14**. Der Standardwert ist der niedrigste zulässige Wert für das Konto, der durch das Land des verbundenen Kontos bestimmt wird. Beim Festlegen oder Aktualisieren dieses Felds können Sie die Zeichenfolge **minimum** übergeben, um den niedrigsten zulässigen Wert auszuwählen. Es gibt vier mögliche Einstellungen für die Eigenschaft `interval`: - **Manuell**: Verhindert automatische Auszahlungen. Sie müssen das Guthaben des Kontos manuell über die [Transfers API](https://docs.stripe.com/api.md#create_transfer) (in der Funktion des verbundenen Kontos) auszahlen. Setzen Sie ein Konto außerdem auf `manuell`, um [Instant Payouts](https://docs.stripe.com/connect/legacy-transfers.md#instant-payouts) zu verwenden. - **Täglich**: Gelder werden automatisch `delay_days` Tage nach der Abwicklung ausgezahlt. Der Wert `delay_days` kann nicht unter dem Wert für Ihren eigenen Auszahlungsplan oder dem Standardwert für den Auszahlungsplan des Kontos liegen. - **weekly**: Das Guthaben wird automatisch jede Woche an dem Tag ausgezahlt, der durch den Parameter `weekly_anchor` angegeben wird (ein Wochentag in Kleinbuchstaben, z. B. **monday**). - **monthly**: Das Guthaben wird automatisch jeden Monat an dem Tag ausgezahlt, der durch den Parameter `monthly_anchor` angegeben wird (eine Zahl zwischen 1 und 31). ## Manuelle Überweisungen verwenden Wenn Sie mit der [Accounts API](https://docs.stripe.com/api.md#account_object-transfer_schedule) den Wert für `transfer_schedule[interval]` auf `manual` setzen, hält Stripe die Gelder im Saldo des Kontoinhabers/der Kontoinhaberin so lange zurück, bis er/sie aufgefordert wird, sie auszuzahlen (oder bis maximal 90 Tage vergangen sind). Um eine Auszahlung dieser Gelder auszulösen, verwenden Sie die [Transfers API](https://docs.stripe.com/api.md#create_transfer). Die Transfers API dient nur dazu, Gelder aus dem Guthaben eines verbundenen Stripe-Kontos auf ein externes Konto zu übertragen. Informationen zum Verschieben von Geldern zwischen Stripe-Konten finden Sie unter [Einrichten separater Zahlungen und Überweisungen](https://docs.stripe.com/connect/separate-charges-and-transfers.md) oder [Einrichten von Destination Charges über die Plattform](https://docs.stripe.com/connect/destination-charges.md). > Der Begriff *Treuhand* hat eine präzise rechtliche Definition und Stripe unterstützt keine Treuhandkonten. Wir bieten jedoch treuhandähnliche Funktionen über manuelle Überweisungen an. Dadurch haben Sie die Kontrolle über den Zeitpunkt der Überweisungen und können Auszahlungen an Custom-Konten um bis zu 90 Tage verzögern. > > Manuelle Überweisungen können als Alternative zum Treuhandkonto verwendet werden, wenn das Risiko einer verspäteten Lieferung besteht oder wenn die Möglichkeit besteht, dass eine Rückerstattung erforderlich wird. ### Standardüberweisungen Ein einfaches Beispiel für eine Überweisung für das Senden von 10 USD vom Stripe-Guthaben eines Custom-Kontos an dessen externes Konto: #### curl ```bash curl https://api.stripe.com/v1/transfers \ -u <>: \ -H "Stripe-Account: {{CONNECTED_STRIPE_ACCOUNT_ID}}" \ -d "amount"=1000 \ -d "currency"="usd" \ -d "destination"="default_for_currency" ``` Mit der Einstellung `destination=default_for_currency` wird Stripe angewiesen, die Überweisung auf das Standard-Bankkonto oder die Debitkarte des Kontos für die angegebene Währung vorzunehmen. Bei einer Standardüberweisung können Sie eine Auszahlung bis zum verfügbaren Saldo der Nutzer/innen vornehmen. Um diesen Betrag zu ermitteln, führen Sie einen Aufruf zum [Abruf des Saldos](https://docs.stripe.com/api.md#retrieve_balance) im Namen der Nutzer/innen durch. Stripe erfasst Saldobeiträge aus verschiedenen Zahlungsquellen in separaten Saldi. Die Antwort zum Abrufen des Saldos schlüsselt die Komponenten jedes Saldos nach der Art der Quelle auf. Wenn Sie beispielsweise eine Überweisung speziell für einen Nicht-Kreditkarten-Saldo erstellen möchten, geben Sie in Ihrer Anfrage den `source_type` an. #### curl ```bash curl https://api.stripe.com/v1/transfers \ -u <>: \ -d "amount"=24784 \ -d "currency"="usd" \ -d "destination"="default_for_currency" \ -d "source_type"="bank_account" ``` Beachten Sie, dass die Saldokomponente jeder Quelle (aufgrund von Rückerstattungen oder Rückbuchungen) in den negativen Bereich fallen kann. Zudem können keine Überweisungen für Beträge erstellt werden, die das verfügbare Gesamtguthaben übersteigen. ### Instant Payouts verwenden Mit Instant Payouts können Sie sofort Gelder auf die Debitkarte eines Custom-Kontos überweisen. Gelder werden in der Regel innerhalb von 30 Minuten auf dem zugehörigen Bankkonto angezeigt, sodass sie innerhalb kurzer Zeit von der Abbuchung zur Auszahlung übergehen können. Um Instant Payouts zu verwenden, geben Sie bei der Erstellung der Überweisung **instant** für die Eigenschaft `method` an: #### curl ```bash curl https://api.stripe.com/v1/transfers \ -u <>: \ -H "Stripe-Account: {{CONNECTED_STRIPE_ACCOUNT_ID}}" \ -d "amount"=1000 \ -d "currency"="usd" \ -d "method"="instant" ``` Instant Payouts unterscheidet sich in mehrfacher Hinsicht von anderen manuellen Überweisungen: - Sie können den verfügbaren Saldo eines Kontos zuzüglich des *ausstehenden* Saldos überweisen. - Instant Payouts kann an Wochenenden und Feiertagen angefordert werden. Anfänglich können Plattformen bis zu 500 USD pro Tag - insgesamt für alle angeschlossenen Konten - über Instant Payouts überweisen. [Kontaktieren Sie uns](https://support.stripe.com/contact), wenn Sie diese Grenze erhöhen möchten. Instant Payouts ist für alle großen US-Banken verfügbar, wird jedoch von einem kleinen Prozentsatz der Banken noch nicht unterstützt. Bei diesen Banken müssen Sie auf Standard-Auszahlungen zurückgreifen. Wenn Sie einem Konto eine Karte hinzufügen, gibt Stripe die Eigenschaft `available_payout_methods` in der Antwort zurück. Hierbei handelt es sich um einen Satz der Zahlungsmethoden, die Stripe für diese Karte unterstützt. Nur Werte aus diesem Satz sollten bei der Erstellung einer Überweisung als `method` übergeben werden. ```json { "id": ""{{CARD_ID}}"", "object": "card", ... "account": "acct_1032D82eZvKYlo2C", "available_payout_methods": ["standard", "instant"], } ``` Wenn die Karte eines Custom-Kontos Instant Payouts nicht unterstützt, sollten Sie dem/der Inhaber/in des Kontos klar mitteilen, dass er/sie die Auszahlungen nicht sofort erhält. ### Webhooks mit Überweisungen verwenden Alle Übertragungsaktivitäten für verbundene Konten können mit [Webhooks](https://docs.stripe.com/webhooks.md) verfolgt werden. (Bei Verwendung von Connect sollten Sie immer Webhooks nutzen.) Speziell für Übertragungen werden die folgenden Ereignisse angezeigt: - `transfer.created` - `transfer.updated` - `transfer.paid` - `transfer.failed` Bei den meisten Überweisungen erfolgen diese Ereignisbenachrichtigungen über mehrere Tage hinweg. Bei Instant Payouts wird `transfer.paid` in der Regel innerhalb von 30 Minuten gesendet. Wenn eine Überweisung nicht abgeschlossen werden kann, tritt das Ereignis `transfer.failed` ein. Die Eigenschaft `failure_reason` des Ereignisses liefert den Grund. ## See also - [Custom-Konten](https://docs.stripe.com/connect/custom-accounts.md) - [Konten aktualisieren](https://docs.stripe.com/connect/updating-service-agreements.md) - [Informationen zu Connect-Kontoguthaben](https://docs.stripe.com/connect/account-balances.md)