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
Webhooks

The Balance Setting object 

Connect
Balance Settings
The Balance Setting object

Attributes

  • objectstring

    String representing the object’s type. Objects of the same type share the same value.

  • debit_negative_balancesnullable boolean

    A Boolean indicating if Stripe should try to reclaim negative balances from an attached bank account. See Understanding Connect account balances for details. The default value is false when controller.requirement_collection is application, which includes Custom accounts, otherwise true.

  • payoutsnullable object

    Settings specific to the account’s payouts.

    • payouts.schedulenullable object

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

      • payouts.schedule.intervalnullable enum

        How frequently funds will be paid out. One of manual (payouts only created via API call), daily, weekly, or monthly.

        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_anchornullable integer

        The day of the month funds will be paid out. Only shown if interval is monthly. Payouts scheduled between the 29th and 31st of the month are sent on the last day of shorter months.

      • payouts.schedule.weekly_anchornullable enum

        The day of the week funds will be paid out, of the style ‘monday’, ‘tuesday’, etc. Only shown 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_descriptornullable string

      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.

    • payouts.statusenum

      Whether the funds in this account can be paid out.

      Possible enum values
      disabled

      Funds in this account cannot be paid out.

      enabled

      Funds in this account can be paid out.

  • settlement_timingobject

    Settings related to the account’s balance settlement timing. See Balances and settlement time to learn more.

    • settlement_timing.delay_daysinteger

      The number of days charge funds are held before becoming available.

The Balance Setting object
{
  "object": "balance_settings",
  "debit_negative_balances": true,
  "payouts": {
    "schedule": {
      "interval": "daily"
    },
    "statement_descriptor": null,
    "status": "enabled"
  },
  "settlement_timing": {
    "delay_days": 2
  }
}