# Financial accounts Use financial accounts to store, send, and receive funds. You can provision different financial accounts with their own distinct balances for your platform and your connected accounts. For example, a connected account on your platform might have a 100 USD payment balance and a 200 USD financial account balance, representing a total balance of 300 USD. These two balances remain separate, but you can move money in and out of these accounts for different purposes depending on which [capabilities you enable for the connected accounts](https://docs.stripe.com/treasury/connect/v2/account-management/connected-accounts.md#how-capabilities-work). ## Financial account features Financial accounts provide the following features for the corresponding active capabilities: | Capability | Description | Functionality | | -------------------------------------------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | | `configuration.money_manager.capabilities.received_credits` | Enables receiving funds into financial accounts, and some outbound payment flows require it. | Create a [Financial Address](https://docs.stripe.com/api/v2/money-management/financial-addresses.md?api-version=preview) to assign bank details (such as account number and sort code in GB) to your financial account. Share these details with customers or partners so they can send funds directly to the financial account. Monitor incoming funds using [received credits](https://docs.stripe.com/treasury/connect/v2/moving-money/fund-a-financial-account.md#monitor-received-credits). Setting up a financial address is also necessary for enabling [outbound payments](https://docs.stripe.com/treasury/connect/v2/moving-money/out-of/outbound-payments.md) to third parties. | | `configuration.money_manager.capabilities.business_storage.inbound` and `configuration.money_manager.capabilities.business_storage.outbound` | Specifies which currencies a connected account’s financial accounts can hold, receive, and send. | Create financial accounts that hold balances in the specified currencies. For example, requesting GBP lets you create financial accounts that hold British pounds. | | `configuration.money_manager.capabilities.outbound_payments` | Enables sending funds to third parties and other connected accounts’ financial accounts. | Use [outbound payments](https://docs.stripe.com/treasury/connect/v2/moving-money/out-of/outbound-payments.md) to pay external recipients (such as suppliers or contractors) or send funds to financial accounts that other connected accounts on your platform own. | | `configuration.money_manager.capabilities.outbound_transfers` | Enables moving funds to external bank accounts or between financial accounts owned by the same connected account. | Use [outbound transfers](https://docs.stripe.com/treasury/connect/v2/moving-money/out-of/outbound-transfers.md) to send funds from a financial account to an external bank account, or move money between multiple financial accounts that the same connected account owns. | ## Balances A financial account balance includes both settled and pending transactions, so the total might not reflect availability. [Retrieve a financial account](https://docs.stripe.com/api/v2/money-management/financial-accounts/retrieve.md?api-version=preview) to view the following balance sub-totals and their currency: - `available`: Funds the user can spend right now. - `inbound_pending`: Funds that aren’t spendable yet, but that will become available later. - `outbound_pending`: Funds in the account, but aren’t spendable because they’re being held for pending outbound flows. ### Negative balances If your connected account has a negative balance in one of their financial accounts, Stripe holds an equivalent reserve on your platform’s [connected reserve balance](https://docs.stripe.com/connect/account-balances.md#understanding-connected-reserve-balances), funded from your platform’s [payments balance](https://docs.stripe.com/payments/balances.md#payments-balance). This reserve automatically releases after the negative balance corrects. After 180 days, Stripe remediates a negative balance by moving funds from your platform reserve to bring the financial account back to zero. Monitor your connected accounts to identify and address negative financial account balances to avoid Stripe interventions. Contact your connected account representative and, if necessary, you can [add funds to a financial account](https://docs.stripe.com/treasury/connect/v2/moving-money/fund-a-financial-account.md). Stripe contacts you if individual or aggregate balances exceed our risk limits. ## Transactions Every movement of funds into or out of a financial account creates a [Transaction](https://docs.stripe.com/api/v2/money-management/transactions.md?api-version=preview) object. Each transaction details the source of the movement, such as an [OutboundTransfer](https://docs.stripe.com/api/v2/money-management/outbound-transfers.md?api-version=preview), [OutboundPayment](https://docs.stripe.com/api/v2/money-management/outbound-transfers/object.md?api-version=preview), or [ReceivedCredit](https://docs.stripe.com/api/v2/money-management/received-credits.md?api-version=preview). ## Close a financial account You can permanently [close a financial account](https://docs.stripe.com/api/v2/money-management/financial-accounts/close.md?api-version=preview) if: - Its [status](https://docs.stripe.com/api/v2/money-management/financial-accounts/retrieve.md?api-version=preview#v2_retrieve_financial_accounts-response-status) is `open`. - Its balance is zero, or you specify [forwarding settings](https://docs.stripe.com/api/v2/money-management/financial-accounts/close.md?api-version=preview#v2_close_financial_accounts-forwarding_settings) to redirect any incoming transactions after closing. ```curl curl -X POST https://api.stripe.com/v2/money_management/financial_accounts/{{FINANCIALACCOUNTID_ID}}/close \ -H "Authorization: Bearer <>" \ -H "Stripe-Version: 2026-02-25.preview" \ -H "Stripe-Context: {{CONTEXT_ID}}" \ --json '{ "forwarding_settings": { "payout_method": "{{ALTERNATIVE_FINANCIAL_ACCOUNT_ID}}", "payment_method": "{{ALTERNATIVE_FINANCIAL_ACCOUNT_ID}}" } }' ``` ## Financial account actions - Create a financial account - Update a financial account - Retrieve a financial account - List financial accounts - List financial account statements - Retrieve a financial account statement - List transactions - Retrieve a transaction - Close a financial account ## Webhooks Listen for and handle the following `v2.money_management` events related to financial account activity. | Event | Triggered | | ----------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `financial_account.created` | A new financial account was created. | | `financial_account.updated` | A financial account was updated. | | `financial_address.activated` | A financial address activated and can receive funds. | | `financial_address.failed` | A financial address failed to activate and can’t receive funds. | | `outbound_payment.canceled` | An outbound payment was canceled before completing. | | `outbound_payment.created` | An outbound payment was created. | | `outbound_payment.failed` | An outbound payment failed to post. | | `outbound_payment.posted` | An outbound payment posted. | | `outbound_payment.returned` | An outbound payment returned. | | `outbound_payment.updated` | An outbound payment was updated. | | `outbound_transfer.canceled` | An outbound transfer was canceled before completing. | | `outbound_transfer.created` | An outbound transfer was created. | | `outbound_transfer.failed` | An outbound transfer failed to post. | | `outbound_transfer.posted` | An outbound transfer posted. | | `outbound_transfer.returned` | An outbound transfer returned. | | `outbound_transfer.updated` | An outbound transfer was updated. | | `payout_method.created` | A payout method was created. | | `payout_method.updated` | A payout method was updated. | | `received_credit.available` | Funds from a received credit settled and you can use them. | | `received_credit.failed` | A payment into the financial account failed. Inspect the [ReceivedCredit status_details](https://docs.stripe.com/api/v2/money-management/received-credits/object.md?api-version=preview#v2_received_credit_object-status_details) for more information. | | `received_credit.returned` | A payment into the financial account was reversed, returned to the originator, and deducted from the balance. | | `received_credit.succeeded` | A payment into the financial account succeeded. | | `transaction.created` | A transaction recording funds movement into or out of the financial account was created. | | `transaction.updated` | A transaction recording funds movement into or out of the financial account was updated. | ## See also - [Build an integration](https://docs.stripe.com/treasury/connect/v2/build-an-integration.md) - [Move money with financial accounts](https://docs.stripe.com/treasury/connect/v2/moving-money/moving-money-with-financial-accounts.md)