Fügt Kontostand- und Auszahlungseinstellungen mit der Balance Settings API hinzu.
Das ändert sich
Mit der Balance Settings API können Sie jetzt anpassen, wie Guthaben und Auszahlungen eines verbundenen Kontos von Ihrer Plattform verwaltet werden. Folgende Optionen sind enthalten:
- payments.debit_negative_balances: bestimmt, ob Stripe versuchen soll, negative Salden von einem verknüpften Bankkonto zurückzufordern.
- payments.payouts.minimum_balance_by_currency: definiert den Mindestguthabenbetrag, der nach automatischen Auszahlungen pro Währung beibehalten werden muss – es werden nur Gelder ausgezahlt, die über diesen Betrag hinaus vorhanden sind.
- payments.payouts.schedule: gibt den genauen Zeitplan für Auszahlungen an, einschließlich des Häufigkeitsintervalls und der Tage des Monats oder der Woche.
- payments.payouts.statement_descriptor: gibt den Text vor, der auf dem Kontoauszug für Auszahlungen erscheint.
- payments.settlement_timing: definiert den Zeitpunkt der Zahlungsabwicklung, an dem ausstehende Geldmittel verfügbar werden.
Wenn Sie die Balance Settings API in Vorschauversionen der API verwendet haben, die älter als 2025-09-30. sind, werden Sie die folgenden Änderungen feststellen:
Fügt die Möglichkeit hinzu, die Saldo-Einstellungen delay_days auf den Standardwert zu setzen, indem Sie einen leeren Wert
delay_eingeben. Der Standardwert ist der niedrigste für Ihr Konto verfügbare Wert.days_ override Das Feld delay_days_override wurde dem Objekt „Saldo-Einstellungen“ hinzugefügt. Sie können Einstellungen vornehmen, wenn Sie die Saldo-Einstellungen aktualisieren.
Auswirkungen
Alle Stripe-Plattformen können jetzt die Balance Settings API verwenden, um Kontostände anzupassen, Mindestguthaben für automatische Auszahlungen zu konfigurieren und Auszahlungseinstellungen zu verwalten.
Wir empfehlen die Verwendung der Balance Settings API sowohl für Accounts v1 als auch für Accounts v2 anstelle des Legacy-Hash settings.payouts in der Accounts v1 API. Wenn Sie jedoch eine Plattform auf Accounts v1 haben und derzeit settings. verwenden, müssen Sie nicht migrieren. Wenn Sie eine Plattform auf Accounts v2 betreiben, finden Sie weitere Informationen unter Erstellen einer SaaS-Plattform.