{"id":"7e8e61ad-3a24-44ab-8127-9a4086425200","task":"Create a Stripe Financial Connections Session to initiate bank account linking","domain":"stripe.com","steps":["Create a Financial Connections Session server-side by POST-ing to /v1/financial_connections/sessions with account_holder (type and customer), permissions array (e.g. ['payment_method', 'balances']), and optionally filters.countries","Return the session's client_secret to your frontend","Use Stripe.js collectBankAccountForPayment or collectBankAccountToken, passing the client_secret to launch the hosted authorization modal","After the user completes the flow, the session status becomes 'succeeded' and linked account IDs are available on the session accounts array","Retrieve the session server-side via GET /v1/financial_connections/sessions/:id to confirm status and collect account IDs","Store the returned financial_connections.account IDs for subsequent data retrieval operations"],"gotchas":["The permissions array must be set at session creation time and cannot be modified later; request only what your use case needs as over-requesting may reduce user consent rates","client_secret is single-use and short-lived; never log or expose it to untrusted parties","Financial Connections Sessions require a Customer object when the account_holder type is 'customer'; omitting the customer causes a validation 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/7e8e61ad-3a24-44ab-8127-9a4086425200"}