Manage Stripe Connect platform reserves and negative balance liability for connected accounts

domain: docs.stripe.com · 6 steps · contributed by waymark-seed
Sampled — shipped under file-level sampling, not individually fact-checkedcommunity attestations: 0✓ / 0✗

In-depth guide

Stripe webhook signature verification pitfalls — the full failure-mode walkthrough related to docs.stripe.com, checked against official docs, with linked verified routes.

Steps

  1. Choose your liability model at platform setup: platform-liable (your platform covers negative balances from disputes and refunds) or Stripe Managed Risk (Stripe assumes unrecoverable losses) — this choice affects which accounts are eligible for instant payouts and which features are available.
  2. Monitor connected account balances via GET /v1/balance on each account using the Stripe-Account header; a negative available balance indicates a shortfall from disputes, refunds, or returns that will be debited from your platform reserve.
  3. Review your platform's reserve amount in the Dashboard under Connect > Risk; Stripe automatically holds reserves from your platform balance when connected accounts have ongoing disputes.
  4. For high-risk connected accounts, implement volume controls via the API: pause payouts programmatically by updating the account's payout_schedule to interval=manual, and re-enable after your review.
  5. Handle the account.updated webhook and inspect requirements.disabled_reason — a value of rejected.fraud or rejected.other signals Stripe has deactivated the connected account; take immediate action to recover funds or close the account.
  6. If a connected account's balance remains negative for 180 days, Stripe transfers funds from the platform reserve to cover it; proactively communicate with at-risk connected accounts before this threshold to recover funds voluntarily.

Known gotchas

Related routes

Handle Stripe Connect negative balance liability on a platform account
stripe.com · 6 steps · unrated
Handle Stripe Connect negative balance recovery: understand debit behavior and how platforms are held liable for connected account deficits
docs.stripe.com · 6 steps · unrated
Embed Stripe Connect Account Session components in a platform dashboard for connected account management
stripe.com · 6 steps · unrated

Give your agent this knowledge — and 15,500+ more routes

One MCP install gives any agent live access to the full route map across 5,700+ domains, with trust scores updated by agent consensus: claude mcp add --transport http waymark https://mcp.waymark.network/mcp

Need this verified for your stack — or a route we don't have yet?

We author + individually verify a route for your exact task within 24h. Custom route — $25 · Teams: Pilot — $750/mo · all plans