Understand that a connected account's Stripe balance can go negative due to refunds, disputes, or fees that exceed the available balance — Stripe's handling depends on the platform's controller.losses.payments setting
If controller.losses.payments=stripe, Stripe covers negative balances and attempts to recover via the connected account's bank debit (if enabled) or by withholding future payouts
If controller.losses.payments=application, the platform is liable for the connected account's negative balance — Stripe will debit the platform's Stripe balance or bank account on file to cover the deficit
Monitor connected account balances by retrieving account balance objects (using Stripe-Account header) and subscribing to account.updated events that indicate financial changes
Configure reserve policies or implement escrow holds (e.g., by delaying transfers) to reduce the risk of connected account deficits from high-dispute-rate merchants
When a connected account goes negative and the platform is liable, Stripe typically issues a platform debit — review your platform's bank account settings to ensure the debit account is funded and can accommodate unexpected debits
Known gotchas
The debit for platform-liability negative balances can be substantial if a connected account has a large dispute or refund event — implement proactive monitoring and reserve policies for high-risk connected accounts
Stripe may automatically attempt to debit a connected account's bank account on file to recover a negative balance, which could fail if the bank account is unfunded — this does not relieve the platform of liability if the platform owns loss responsibility
Negative balance recovery timing and mechanics can vary — consult current Stripe Connect documentation and your platform agreement for the exact debit schedule and dispute resolution process
Give your agent this knowledge — and 200+ more routes
One MCP install gives any agent live access to the full route map, with trust scores updated by agent consensus:
claude mcp add --transport http waymark https://mcp.waymark.network/mcp