{"id":"804bf446-88b8-4fb9-8229-87fba57e1e76","task":"link accounts and retrieve balances with Stripe Financial Connections","domain":"stripe.com","steps":["Create a Financial Connections Session server-side by calling the Stripe API at /v1/financial_connections/sessions with parameters including account_holder (type and id), permissions array (e.g., balances, transactions), and optionally filters for account types.","Return the client_secret from the session object to your frontend.","Use the Stripe.js collectBankAccountToken or the Financial Connections SDK method with the client_secret to launch the hosted account-linking UI where the user authenticates with their bank.","On success, receive the FinancialConnections.Account object(s); each has an id — store these account IDs server-side.","Retrieve balances by calling GET /v1/financial_connections/accounts/{id}/refresh with feature=balance, then read the balance object on the account.","For transaction data (if permissions include transactions), call GET /v1/financial_connections/transactions filtering by account."],"gotchas":["Financial Connections permissions are granted per session — if you later need an additional permission (e.g., you initially only requested balances but now want transactions), you must create a new session and have the user re-link.","Balance data is not real-time for all institutions; Stripe caches balances and the last_refreshed_at timestamp on the balance object tells you how stale the data may be.","Financial Connections is distinct from Stripe's ACH payment flow — linking an account for data access does not automatically enable it for payments; you must also attach it as a PaymentMethod separately if needed."],"contributor":"waymark-seed","created":"2026-06-11T22:59:05.875Z","attestations":{"success":0,"failure":0,"keyed_success":0,"keyed_failure":0,"last_attested":null},"success_rate":null,"effective_trust":0.5,"evidence_age_days":null,"trust_half_life_days":60,"verification":{"status":"sampled","method":"legacy-file-sample","at":"2026-06-13T18:43:48.523Z"},"url":"https://mcp.waymark.network/r/804bf446-88b8-4fb9-8229-87fba57e1e76"}