Core Resources
Payment Methods
Money Management
Products
Checkout
Payment Links
Billing
Capital
Connect
Fraud
Issuing
Terminal
Treasury
Payment Records
Entitlements
Sigma
Reporting
Financial Connections
Tax
Identity
Crypto
Climate
Forwarding
Privacy
Webhooks

Update balance settings 

Connect
Balance Settings
Update balance settings

Updates balance settings for a given connected account. Related guide: Making API calls for connected accounts

Parameters

  • debit_negative_balancesboolean

    A Boolean indicating whether Stripe should try to reclaim negative balances from an attached bank account. For details, see Understanding Connect Account Balances.

  • payoutsobject

    Settings specific to the account’s payouts.

    • payouts.scheduleobject

      Details on when funds from charges are available, and when they are paid out to an external account. For details, see our Setting Bank and Debit Card Payouts documentation.

      • payouts.schedule.intervalenum

        How frequently available funds are paid out. One of: daily, manual, weekly, or monthly. Default is daily.

        Possible enum values
        daily

        Stripe automatically sends money to your bank account daily

        manual

        You manually send funds to your bank account

        monthly

        Stripe automatically sends money to your bank account monthly

        weekly

        Stripe automatically sends money to your bank account weekly

      • payouts.schedule.monthly_anchorinteger

        The day of the month when available funds are paid out, specified as a number between 1–31. Payouts nominally scheduled between the 29th and 31st of the month are instead sent on the last day of a shorter month. Required and applicable only if interval is monthly.

      • payouts.schedule.weekly_anchorenum

        The day of the week when available funds are paid out (required and applicable only if interval is weekly.)

        Possible enum values
        friday

        Available funds are paid out on Friday

        monday

        Available funds are paid out on Monday

        thursday

        Available funds are paid out on Thursday

        tuesday

        Available funds are paid out on Tuesday

        wednesday

        Available funds are paid out on Wednesday

    • payouts.statement_descriptorstring

      The text that appears on the bank account statement for payouts. If not set, this defaults to the platform’s bank descriptor as set in the Dashboard.

  • settlement_timingobject

    Settings related to the account’s balance settlement timing.

    • settlement_timing.delay_daysinteger

      The number of days charge funds are held before becoming available. May also be set to minimum, representing the lowest available value for the account country. Default is minimum. The delay_days parameter remains at the last configured value if payouts.schedule.interval is manual. Learn more about controlling payout delay days.

Returns

Returns the updated balance settings object for the account that was authenticated in the request.

POST /v1/balance_settings
curl https://api.stripe.com/v1/balance_settings \
  -u "sk_test_BQokikJ...2HlWgH4olfQ2sk_test_BQokikJOvBiI2HlWgH4olfQ2:" \
  -H "Stripe-Version: 2025-05-28.preview" \
  -H "Stripe-Account: {{CONNECTED_ACCOUNT_ID}}" \
  -d "payouts[schedule][interval]"=monthly \
  -d "payouts[schedule][monthly_anchor]"=5
Response
{
  "object": "balance_settings",
  "debit_negative_balances": true,
  "payouts": {
    "schedule": {
      "interval": "monthly",
      "monthly_anchor": 5
    },
    "statement_descriptor": null,
    "status": "enabled"
  },
  "settlement_timing": {
    "delay_days": 2
  }
}