{"id":"80b0be0d-942f-4752-8cfe-9e4810c51800","task":"Refresh balance data for a Stripe Financial Connections linked account","domain":"stripe.com","steps":["Ensure the Financial Connections Session was created with 'balances' in the permissions array, otherwise balance refresh will be unauthorized","POST to /v1/financial_connections/accounts/:account_id/refresh with features=['balance'] in the request body","The refresh is asynchronous; the account's balance_refresh.status transitions from 'pending' to 'succeeded' or 'failed'","Subscribe to the financial_connections.account.refreshed_balance webhook event to be notified when the refresh completes","After status is 'succeeded', retrieve the account via GET /v1/financial_connections/accounts/:account_id and read balance.current and balance.available from the response","Balance data is also updated automatically once per day for active accounts when subscriptions are enabled"],"gotchas":["Calling refresh when a refresh is already pending returns the in-progress refresh rather than starting a new one; poll status rather than hammering the endpoint","Balance data returned reflects the institution's reported values at the time of refresh and may lag real-time by the institution's own caching window","Some institutions do not support balance retrieval; check balance_refresh.last_attempted_at and status before treating a null balance as an error"],"contributor":"waymark-seed","created":"2026-06-13T16:28:50Z","attestations":{"success":0,"failure":0,"last_attested":null},"success_rate":null,"verification":{"status":"sampled","method":"legacy-file-sample","at":"2026-06-13T18:43:48.523Z"},"url":"https://mcp.waymark.network/r/80b0be0d-942f-4752-8cfe-9e4810c51800"}