[ Web Proxy ]
URL:
Viewing: https://docs.stripe.com/api/balance-settings [Back]  [Original]

Balance Settings | Stripe API Reference
Find anything
/
Ask AI

Balance Settings

Options for customizing account balances and payout settings for a Stripe platforms connected accounts.

Was this section helpful?YesNo
Update balance settings
POST/v1/balance_settings
Retrieve balance settings
GET/v1/balance_settings

The Balance Setting object

Attributes

  • objectstring

    String representing the objects type. Objects of the same type share the same value.

  • paymentsobject

    Settings that apply to the Payments Balance.

    Show child attributes
The Balance Setting object
{
"object": "balance_settings",
"payments": {
"debit_negative_balances": true,
"payouts": {
"automatic_transfer_rules_by_currency": {
"usd": [
{
"type": "transfer_all",
"payout_method": "fa_1ABC"
}
]
},
"minimum_balance_by_currency": {
"usd": 1500,
"cad": 8000
},
"schedule": {
"interval": "weekly",
"weekly_payout_days": [
"monday",
"wednesday"
]
},
"statement_descriptor": null,
"status": "enabled"
},
"settlement_timing": {
"delay_days_override": 3,
"delay_days": 3
}
}
}

Update balance settings

POST/v1/balance_settings

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

Parameters

Returns

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

curl https://api.stripe.com/v1/balance_settings \
-u "sk_test_wU7nrJCZspk1NPDxiQgAF05qsk_test_wU7nrJCZspk1NPDxiQgAF05q:" \
-H "Stripe-Account: {{CONNECTED_ACCOUNT_ID}}" \
-d "payments[payouts][schedule][interval]=monthly" \
-d "payments[payouts][schedule][monthly_payout_days][]=5" \
-d "payments[payouts][schedule][monthly_payout_days][]=20"
Response
{
"object": "balance_settings",
"payments": {
"debit_negative_balances": true,
"payouts": {
"automatic_transfer_rules_by_currency": {
"usd": [
{
"type": "transfer_all",
"payout_method": "fa_1ABC"
}
]
},
"minimum_balance_by_currency": {
"usd": 1500,
"cad": 8000
},
"schedule": {
"interval": "monthly",
"monthly_payout_days": [
5,
20
]
},
"statement_descriptor": null,
"status": "enabled"
},
"settlement_timing": {
"delay_days_override": 3,
"delay_days": 3
}
}
}

Web Proxy Viewer  |  New URL  |  Original Page