Auszahlungsplan verwalten

Verwalten Sie den Zeitplan für automatische Auszahlungen an Ihre verbundenen Konten.

Notiz

Verwenden Sie die Balance Settings API, um die Auszahlungseinstellungen sowohl für Accounts v1 als auch Accounts v2 zu verwalten. Das Balance-Settings-Objekt folgt einer ähnlichen Struktur und Funktionsweise wie der Hash settings.payouts in Accounts v1. Wenn Ihr Account v1 derzeit settings.payouts verwendet, ist keine Migration erforderlich.

Bei Verwendung automatischer Auszahlungen enthält der Hash payments.payouts.schedule Informationen darüber, wann Gelder eines Stripe-Kontos verfügbar sind und wann das Guthaben automatisch ausgezahlt wird:

{
  "object": "balance_settings",
  "payments": {
    "debit_negative_balances": true,
    "payouts": {
      "minimum_balance_by_currency": {
        "usd": 1500,
        "cad": 8000
      },
      "schedule": {
        "interval": "weekly",
        "weekly_payout_days": ["monday", "wednesday"],
        "monthly_payout_days": null
      },
      "statement_descriptor": null,
      "status": "enabled"
    },
    "settlement_timing": {
      "delay_days_override": 3,
      "delay_days": 3
    }
  }
}

delay_days-Eigenschaft

Die Eigenschaft settlement_timing.delay_days gibt an, wie lange es dauert, bis on_behalf_of Zahlungen (oder Direct Charges, die auf dem verbundenen Konto durchgeführt wurden) für eine Auszahlung zur Verfügung stehen. Sie können diese Eigenschaft bei Konten bearbeiten, bei denen Sie für Betrugs- und Anfechtungshaftung verantwortlich sind. Diese Eigenschaft kann überschrieben werden, indem delay_days_override auf eine Zahl bis zu 31 gesetzt wird. Wenn Sie einen leeren String an delay_days_override übergeben, wird delay_days auf den Standardwert zurückgesetzt, also den niedrigsten verfügbaren Wert für das Konto.

Dieses Feld ist nützlich, um automatische Auszahlungen zu steuern. Stripe berechnet die Verzögerung in Werktagen oder Kalendertagen, abhängig vom Land des verbundenen Kontos. Wenn Sie beispielsweise möchten, dass ein verbundenes Konto mit Sitz in Singapur (das Kalendertagsverzögerungen verwendet) seine Gelder zwei Wochen nach der Belastung erhält, setzen Sie Intervall auf täglich und delay_days_override auf 14.

Für Konten, deren Betrugs- und Anfechtungshaftung Stripe verwaltet (z. B. Standardkonten) ist der Standardwert der kleinste zulässige Wert für das Konto, der sich nach dem Land des verbundenen Kontos richtet. Bei Konten, für die Sie die Haftung bei Betrug und Zahlungsanfechtungen verwalten, bleibt der Wert standardmäßig bei Ihrer ursprünglichen Auszahlungsgeschwindigkeit.

Intervall-Eigenschaft

Plattformen, die Betrugs- und Haftungsanfechtungen verwalten oder über Plattform-Steuerelemente verfügen, können das Auszahlungsintervall anpassen. Es gibt vier mögliche Einstellungen für die Eigenschaft interval:

Manuell: Diese Einstellung verhindert automatische Auszahlungen. Das Guthaben des Kontos muss über die Payouts API (als verbundenes Konto) manuell ausgezahlt werden. Außerdem wird manual eingestellt, um Instant Payouts mit dem Konto nutzen zu können.
Täglich: Bei dieser Einstellung werden Gelder 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.
wöchentlich: Diese Einstellung zahlt das Guthaben mindestens einmal pro Woche automatisch aus, an den Tagen, die durch den Parameter weekly_payout_days (ein Array mit Wochentagen) festgelegt sind.
monatlich: Bei dieser Einstellung wird das Guthaben automatisch mindestens einmal im Monat ausgezahlt, wie durch den Parameter monthly_payout_days (ein Array von Zahlen zwischen 1-31) festgelegt. Auszahlungen, die nominell zwischen dem 29. und 31. des Monats geplant sind, werden stattdessen am letzten Tag eines kürzeren Monats gesendet.