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

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.

  • settlement_timingobject

    Settings related to the account’s balance settlement timing.

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-07-30.preview" \
  -H "Stripe-Account: {{CONNECTED_ACCOUNT_ID}}" \
  -d "payouts[schedule][interval]"=monthly \
  -d "payouts[schedule][monthly_payout_days][]"=5 \
  -d "payouts[schedule][monthly_payout_days][]"=20
Response
{
  "object": "balance_settings",
  "debit_negative_balances": true,
  "payouts": {
    "schedule": {
      "interval": "monthly",
      "monthly_payout_days": [
        5,
        20
      ]
    },
    "statement_descriptor": null,
    "status": "enabled"
  },
  "settlement_timing": {
    "delay_days": 2
  }
}

Retrieve balance settings 

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

Parameters

No parameters.

Returns

Returns a balance settings object for the account specified in the request.

GET /v1/balance_settings
curl https://api.stripe.com/v1/balance_settings \
  -u "sk_test_BQokikJ...2HlWgH4olfQ2sk_test_BQokikJOvBiI2HlWgH4olfQ2:" \
  -H "Stripe-Version: 2025-07-30.preview" \
  -H "Stripe-Account: {{CONNECTED_ACCOUNT_ID}}"
Response
{
  "object": "balance_settings",
  "debit_negative_balances": true,
  "payouts": {
    "schedule": {
      "interval": "daily"
    },
    "statement_descriptor": null,
    "status": "enabled"
  },
  "settlement_timing": {
    "delay_days": 2
  }
}

External Bank Accounts 

External bank accounts are financial accounts associated with a Stripe platform’s connected accounts for the purpose of transferring funds to or from the connected account’s Stripe balance.

This API is only available for users enrolled in the public preview for Accounts v2 on Stripe Connect. If you are not in this preview, please use the Accounts v1 API to manage your connected accounts’ external bank accounts instead.

Endpoints

External Account Cards 

External account cards are debit cards associated with a Stripe platform’s connected accounts for the purpose of transferring funds to or from the connected accounts Stripe balance.

This API is only available for users enrolled in the public preview for Accounts v2 on Stripe Connect. If you are not in this preview, please use the Accounts v1 API to manage your connected accounts’ external bank accounts instead.

Endpoints

Person 

This is an object representing a person associated with a Stripe account.

A platform can only access a subset of data in a person for an account where account.controller.requirement_collection is stripe, which includes Standard and Express accounts, after creating an Account Link or Account Session to start Connect onboarding.

See the Standard onboarding or Express onboarding documentation for information about prefilling information and account onboarding steps. Learn more about handling identity verification with the API.

Endpoints