Balance Settings API でアカウント残高と入金設定を追加
新機能
Balance Settings API を使用して、連結アカウントの残高と入金の管理方法をプラットフォームでカスタマイズできるようになりました。以下のオプションが含まれます。
- payments.debit_negative_balances: Stripe が関連付けられた銀行口座からマイナス残高を回収するかどうかを決定します。
- payments.payouts.minimum_balance_by_currency: 自動入金後に通貨ごとに保持する最小残高を定義します。その通貨を超える売上のみが入金されます。
- payments.payouts.schedule: 頻度間隔や月または週の曜日を含む、正確な入金スケジュールを指定します。
- payments.payouts.statement_descriptor: 入金の銀行口座明細書に表示されるテキストを指定します。
- payments.settlement_timing: 未決済の売上処理が可能になるタイミングを定義します。
Balance Settings API をプレビュー版 API の 2025-09-30. より前のバージョンで使用していた場合、以下の点が変更されています。
空の
delay_値を投稿することで、Balance Settings delay_days をデフォルトに設定する機能を追加します。デフォルト値はアカウントで利用可能な最低値です。days_ override Balance Settings オブジェクト に追加された delay_days_override フィールドは、Balance Settings を更新する際に設定することができます。
影響
すべての Stripe プラットフォームで Balance Settings API を使用して、アカウント残高のカスタマイズ、自動入金の最小残高の設定、入金設定の管理 を実行できるようになりました。
Accounts v1 と Accounts v2 のどちらの場合でも、旧式の settings.payouts ハッシュ (Accounts v1 API 内) ではなく、Balance Settings API を使用することを推奨します。ただし、Accounts v1 を使用しており、現在すでに settings. を利用しているプラットフォームの場合は、移行する必要はありません。一方、Accounts v2 を使用しているプラットフォームの場合は、SaaS プラットフォーム構築ガイド を参照してください。