Balances

Balances renders the balance summary for the connected account, and information about any upcoming payouts. If you enable the balances component, connected accounts can also perform instant or manual payouts, or edit their payout schedule and external bank accounts. If Stripe is liable for a connected account’s negative balances, connected accounts can also proactively add money to their balance to avoid a negative balance and prevent business disruptions.

When creating an Account Session, enable balances by specifying balances in the components parameter. You can enable or disable individual features of the balances component by specifying the features parameter under balances:

curl https://api.stripe.com/v1/account_sessions \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -d account=
{{CONNECTED_ACCOUNT_ID}} \
  -d "components[balances][enabled]"=true \
  -d "components[balances][features][instant_payouts]"=true \
  -d "components[balances][features][standard_payouts]"=true \
  -d "components[balances][features][edit_payout_schedule]"=true \
  -d "components[balances][features][external_account_collection]"=true

After creating the account session and initializing ConnectJS, you can render the balances component in the front end:

// Include this element in your HTML
const balances = stripeConnectInstance.create('balances');
container.appendChild(balances);

Enabling Instant Payouts might require additional steps:

• If your platform collects fees for a connected account, you must set up Instant Payout monetization in the Dashboard.
• If your platform is liable for a connected account’s negative balances, your platform must be in a supported country and the account must be in the same country as the platform and must be in the local currency.
• If Stripe is liable for a connected account’s negative balances, Stripe controls eligibility for the account.