Kontrolle über Bank- und Debitkartenüberweisungen

Standardmäßig werden alle Zahlungen, die Sie im Namen eines verbundenen Kontos vornehmen, im Stripe-Saldo 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 festlegen
• Steuern, wie oft Gelder automatisch ausgezahlt werden
• Manuelle Überweisungen durchführen
• Gelder sofort 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.

{
  "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"
      },
      {...},
      {...},
    ],
  ...
}

Zielkonten werden über den Parameter external_accounts hinzugefügt, wenn Stripe-Konten erstellt oder aktualisiert werden. Der Wert sollte ein von Stripe.js 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
• 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 und Karten.

curl https://api.stripe.com/v1/accounts/
{{CONNECTED_ACCOUNT_ID}}
/external_accounts \
  -u "
sk_test_4eC39HqLyjWDarjtT1zdp7dc
:" \
  -d external_account=
{{BANK_ACCOUNT_TOKEN_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, 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:

{
  ...
  "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 (als verbundenes Konto) auszahlen. Setzen Sie ein Konto außerdem auf manual, um Instant Payouts zu verwenden.
• daily: Zahlungen werden automatisch delay_days Tage nach ihrer Erstellung ausgezahlt. Der Wert im Feld delay_days darf nicht kleiner sein als Ihr eigener Überweisungszeitplan bzw. der Standard-Überweisungszeitplan für das Konto.
• 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 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.

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 oder Einrichten von Destination Charges über die Plattform.

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 https://api.stripe.com/v1/transfers \
  -u 
sk_test_4eC39HqLyjWDarjtT1zdp7dc
: \
  -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 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 https://api.stripe.com/v1/transfers \
  -u 
sk_test_4eC39HqLyjWDarjtT1zdp7dc
: \
  -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 https://api.stripe.com/v1/transfers \
  -u 
sk_test_4eC39HqLyjWDarjtT1zdp7dc
: \
  -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, 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 Standardauszahlungen 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.

{
  "id": 
"{{CARD_ID}}",
  "object": "card",
  ...
  "account": "acct_1032D82eZvKYlo2C",
  "available_payout_methods": ["standard", "instant"],
}

Wenn die Karte eines Custom-Kontos keine Unterstützung für Instant Payouts bietet, sollten Sie dem/der Inhaber/in dieses Kontos deutlich mitteilen, dass er/sie Auszahlungen nicht sofort erhält.

Webhooks mit Überweisungen verwenden

Alle Übertragungsaktivitäten für verbundene Konten können mit Webhooks 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.