# Working with Treasury financial accounts

Use financial accounts to store, send, and receive funds.

After you [gain API access to Treasury](https://docs.stripe.com/treasury/access.md), Stripe attaches a financial account to your platform account and enables you to provision financial accounts for eligible connected accounts on your platform. Each financial account has its own distinct [balance of funds](https://docs.stripe.com/treasury/account-management/working-with-balances-and-transactions.md), separate from the balance of the account it’s linked to. For example, the owner of a connected account on your platform might have a 100 USD connected account balance and a 200 USD financial account balance. In this scenario, the connected account owner has a sum of 300 USD spread between their financial account and connected account balances. These two balances remain separate, but the API provides the ability to move money from the connected account balance to the financial account balance.

In the Stripe API, `FinancialAccount` objects serve as the source and destination of money movement API requests. You request `Features` through the API to assign to `FinancialAccounts` that provide additional functionality for the financial accounts on your platform. For example, to enable payment card features on a specific financial account, you send an API request with the `FinancialAccount` ID for the `card_issuing` feature. See [Financial account features](https://docs.stripe.com/treasury/account-management/financial-account-features.md) for more information on `Feature` objects. See the [Available features](https://docs.stripe.com/treasury/account-management/financial-account-features.md#available-features) section within that guide to check required connected account capabilities for each `Feature`.

Before you create financial accounts in live mode for your Treasury integration, we recommend you first create test financial accounts in a *sandbox* (A sandbox is an isolated test environment that allows you to test Stripe functionality in your account without affecting your live integration. Use sandboxes to safely experiment with new features and changes) environment. Test financial accounts can’t receive or send real money, can’t be used in live mode, and don’t generate a live account with real routing and account information, but are otherwise identical in configuration and functionality.

## Create a FinancialAccount

Use `POST /v1/treasury/financial_accounts` to create `FinancialAccounts`. Include the connected account ID as the value of the `Stripe-Account` header of the call to associate the `FinancialAccount` with a connected account.

Your platform account and connected accounts can have multiple financial accounts associated with them. You can create another financial account on your connected account by providing the connected account ID as the value of the `Stripe-Account` header. You can associate a maximum of 3 financial accounts to a single connected account (closed financial accounts don’t contribute to the limit). The same limit applies to the number of financial accounts attached to the platform account. If you need a higher account threshold, contact [treasury-support@stripe.com](mailto:treasury-support@stripe.com).

The following JSON defines the `FinancialAccount` object structure:

#### JSON (commented)

```json
{
  "object": "treasury.financial_account",
  "created": 1612927106,
  "id": "fa_123",
  "country": "US",
  "supported_currencies": ["usd"],
  // Arrays of active, pending and restricted features summarize the status of all requested features
  "active_features": ["financial_addresses.aba", "deposit_insurance"],
  "pending_features": ["inbound_transfers.ach"],
  "restricted_features": ["intra_stripe_flows", "outbound_payments.ach", "outbound_payments.us_domestic_wire"],
  "balance": {
    "cash": {"usd": 9000},
    "inbound_pending": {"usd": 0},
    "outbound_pending": {"usd": 1000}
  },
  // The FinancialAccount gains a FinancialAddress once the `financial_addresses.aba` feature is active. For more information, see "Activating features"
  "financial_addresses": [
    {
      "type": "aba",
      "supported_networks": ["ach", "domestic_wire_us"],
      "aba": {
        "account_number_last4": "7890",
        // Use the expand[] parameter to view the `account_number` field hidden by default
        "account_number": "1234567890",
        "routing_number": "000000001",
        "bank_name": "Goldman Sachs"
      }
    }
  ],
  "livemode": true,
  // Financial accounts begin in the "open" state, but can be closed
  // `status_details.closed` is populated once a financial account is closed
  "status": "open",
  "status_details": {
    "closed": {
      // List of one or more reasons why the FinancialAccount was closed:
      // - account_rejected
      // - closed_by_platform
      // - other
      "reasons": [],
    }
  },
  // User-defined metadata
  "metadata": {},
  "nickname": {},
  // Restrictions that the platform can apply to the FinancialAccount
  "platform_restrictions": {
    "inbound_flows": "unrestricted",
    "outbound_flows": "restricted"
  },
}
```

#### JSON

```json
{
  "object": "treasury.financial_account",
  "created": 1612927106,
  "id": "fa_123",
  "country": "US",
  "supported_currencies": ["usd"],
  "active_features": ["financial_addresses.aba", "deposit_insurance"],
  "pending_features": ["inbound_transfers.ach"],
  "restricted_features": ["intra_stripe_flows", "outbound_payments.ach", "outbound_payments.us_domestic_wire"],
  "balance": {
    "cash": {"usd": 9000},
    "inbound_pending": {"usd": 0},
    "outbound_pending": {"usd": 1000}
  },
  "financial_addresses": [
    {
      "type": "aba",
      "supported_networks": ["ach", "domestic_wire_us"],
      "aba": {
        "account_number_last4": "7890",
        "account_number": "1234567890",
        "routing_number": "000000001",
        "bank_name": "Goldman Sachs"
      }
    }
  ],
  "livemode": true,
  "status": "open",
  "status_details": {
    "closed": null
  },
  "metadata": {},
  "platform_restrictions": {
    "inbound_flows": "unrestricted",
    "outbound_flows": "restricted"
  },
}
```

Typically, you also request [financial account features](https://docs.stripe.com/treasury/account-management/financial-account-features.md) when you make the API request to create the account. Regardless of the `Features` you request, the connected account must have the `treasury` capability enabled. If you’re unsure if the connected account has the capability, use `GET /v1/accounts/{{CONNECTED_ACCOUNT_ID}}` to check. The account’s `capabilities` hash must have a `treasury` value of `active`.

```json
…
  "capabilities": {
    "card_issuing": "active",
    "card_payments": "active",
    "transfers": "active","treasury": "active",
    "us_bank_account_ach_payments": "active"
  },
…
```

If you want to issue cards attached to the financial account balance, your platform’s connected accounts must also have the Issuing (`card_issuing`) capability enabled. The connected account must have this capability before you can request the `card_issuing` feature for its financial account. If the connected account doesn’t have the capability, attempting to create a `FinancialAccount` with a request for the `card_issuing` feature results in an error.

Set the `nickname` field of a `FinancialAccount` object to designate a custom name for the financial account. You can use nicknames to create identifiers, which is useful when working with multiple financial accounts under a single connected account. Valid nicknames must:

- Be a non-blank string
- Contain less than 250 characters

If you don’t provide a nickname upon account creation, the nickname field will be empty and will return `null`. You can [update](https://docs.stripe.com/treasury/account-management/financial-accounts.md#update-a-financialaccount) nicknames after creating a `FinancialAccount`.

The following request creates a financial account assigned to the connected account with the ID assigned in the `Stripe-Account` header.

```curl
curl https://api.stripe.com/v1/treasury/financial_accounts \
  -u "<<YOUR_SECRET_KEY>>:" \
  -H "Stripe-Account: {{CONNECTEDACCOUNT_ID}}" \
  -d "supported_currencies[]"=usd \
  -d nickname={{OPTIONAL_NICKNAME}} \
  -d "features[card_issuing][requested]"=true \
  -d "features[deposit_insurance][requested]"=true \
  -d "features[financial_addresses][aba][requested]"=true \
  -d "features[inbound_transfers][ach][requested]"=true \
  -d "features[intra_stripe_flows][requested]"=true \
  -d "features[outbound_payments][ach][requested]"=true \
  -d "features[outbound_payments][us_domestic_wire][requested]"=true \
  -d "features[outbound_transfers][ach][requested]"=true \
  -d "features[outbound_transfers][us_domestic_wire][requested]"=true
```

```cli
stripe treasury financial_accounts create  \
  --stripe-account {{CONNECTEDACCOUNT_ID}} \
  -d "supported_currencies[0]"=usd \
  --nickname={{OPTIONAL_NICKNAME}} \
  -d "features[card_issuing][requested]"=true \
  -d "features[deposit_insurance][requested]"=true \
  -d "features[financial_addresses][aba][requested]"=true \
  -d "features[inbound_transfers][ach][requested]"=true \
  -d "features[intra_stripe_flows][requested]"=true \
  -d "features[outbound_payments][ach][requested]"=true \
  -d "features[outbound_payments][us_domestic_wire][requested]"=true \
  -d "features[outbound_transfers][ach][requested]"=true \
  -d "features[outbound_transfers][us_domestic_wire][requested]"=true
```

```ruby
# Set your secret key. Remember to switch to your live secret key in production.
# See your keys here: https://dashboard.stripe.com/apikeys
Stripe.api_key = '<<YOUR_SECRET_KEY>>'

financial_account = Stripe::Treasury::FinancialAccount.create(
  {
    supported_currencies: ['usd'],
    nickname: '{{OPTIONAL_NICKNAME}}',
    features: {
      card_issuing: {requested: true},
      deposit_insurance: {requested: true},
      financial_addresses: {aba: {requested: true}},
      inbound_transfers: {ach: {requested: true}},
      intra_stripe_flows: {requested: true},
      outbound_payments: {
        ach: {requested: true},
        us_domestic_wire: {requested: true},
      },
      outbound_transfers: {
        ach: {requested: true},
        us_domestic_wire: {requested: true},
      },
    },
  },
  {stripe_account: '{{CONNECTEDACCOUNT_ID}}'},
)
```

```ruby
# Set your secret key. Remember to switch to your live secret key in production.
# See your keys here: https://dashboard.stripe.com/apikeys
client = Stripe::StripeClient.new("<<YOUR_SECRET_KEY>>")

financial_account = client.v1.treasury.financial_accounts.create(
  {
    supported_currencies: ['usd'],
    nickname: '{{OPTIONAL_NICKNAME}}',
    features: {
      card_issuing: {requested: true},
      deposit_insurance: {requested: true},
      financial_addresses: {aba: {requested: true}},
      inbound_transfers: {ach: {requested: true}},
      intra_stripe_flows: {requested: true},
      outbound_payments: {
        ach: {requested: true},
        us_domestic_wire: {requested: true},
      },
      outbound_transfers: {
        ach: {requested: true},
        us_domestic_wire: {requested: true},
      },
    },
  },
  {stripe_account: '{{CONNECTEDACCOUNT_ID}}'},
)
```

```python
# Set your secret key. Remember to switch to your live secret key in production.
# See your keys here: https://dashboard.stripe.com/apikeys
import stripe
stripe.api_key = "<<YOUR_SECRET_KEY>>"

financial_account = stripe.treasury.FinancialAccount.create(
  supported_currencies=["usd"],
  nickname="{{OPTIONAL_NICKNAME}}",
  features={
    "card_issuing": {"requested": True},
    "deposit_insurance": {"requested": True},
    "financial_addresses": {"aba": {"requested": True}},
    "inbound_transfers": {"ach": {"requested": True}},
    "intra_stripe_flows": {"requested": True},
    "outbound_payments": {
      "ach": {"requested": True},
      "us_domestic_wire": {"requested": True},
    },
    "outbound_transfers": {
      "ach": {"requested": True},
      "us_domestic_wire": {"requested": True},
    },
  },
  stripe_account="{{CONNECTEDACCOUNT_ID}}",
)
```

```python
# Set your secret key. Remember to switch to your live secret key in production.
# See your keys here: https://dashboard.stripe.com/apikeys
client = StripeClient("<<YOUR_SECRET_KEY>>")

# For SDK versions 12.4.0 or lower, remove '.v1' from the following line.
financial_account = client.v1.treasury.financial_accounts.create(
  {
    "supported_currencies": ["usd"],
    "nickname": "{{OPTIONAL_NICKNAME}}",
    "features": {
      "card_issuing": {"requested": True},
      "deposit_insurance": {"requested": True},
      "financial_addresses": {"aba": {"requested": True}},
      "inbound_transfers": {"ach": {"requested": True}},
      "intra_stripe_flows": {"requested": True},
      "outbound_payments": {
        "ach": {"requested": True},
        "us_domestic_wire": {"requested": True},
      },
      "outbound_transfers": {
        "ach": {"requested": True},
        "us_domestic_wire": {"requested": True},
      },
    },
  },
  {"stripe_account": "{{CONNECTEDACCOUNT_ID}}"},
)
```

```php
// Set your secret key. Remember to switch to your live secret key in production.
// See your keys here: https://dashboard.stripe.com/apikeys
$stripe = new \Stripe\StripeClient('<<YOUR_SECRET_KEY>>');

$financialAccount = $stripe->treasury->financialAccounts->create(
  [
    'supported_currencies' => ['usd'],
    'nickname' => '{{OPTIONAL_NICKNAME}}',
    'features' => [
      'card_issuing' => ['requested' => true],
      'deposit_insurance' => ['requested' => true],
      'financial_addresses' => ['aba' => ['requested' => true]],
      'inbound_transfers' => ['ach' => ['requested' => true]],
      'intra_stripe_flows' => ['requested' => true],
      'outbound_payments' => [
        'ach' => ['requested' => true],
        'us_domestic_wire' => ['requested' => true],
      ],
      'outbound_transfers' => [
        'ach' => ['requested' => true],
        'us_domestic_wire' => ['requested' => true],
      ],
    ],
  ],
  ['stripe_account' => '{{CONNECTEDACCOUNT_ID}}']
);
```

```java
// Set your secret key. Remember to switch to your live secret key in production.
// See your keys here: https://dashboard.stripe.com/apikeys
Stripe.apiKey = "<<YOUR_SECRET_KEY>>";

FinancialAccountCreateParams params =
  FinancialAccountCreateParams.builder()
    .addSupportedCurrency("usd")
    .setNickname("{{OPTIONAL_NICKNAME}}")
    .setFeatures(
      FinancialAccountCreateParams.Features.builder()
        .setDepositInsurance(
          FinancialAccountCreateParams.Features.DepositInsurance.builder()
            .setRequested(true)
            .build()
        )
        .setFinancialAddresses(
          FinancialAccountCreateParams.Features.FinancialAddresses.builder()
            .setAba(
              FinancialAccountCreateParams.Features.FinancialAddresses.Aba.builder()
                .setRequested(true)
                .build()
            )
            .build()
        )
        .setInboundTransfers(
          FinancialAccountCreateParams.Features.InboundTransfers.builder()
            .setAch(
              FinancialAccountCreateParams.Features.InboundTransfers.Ach.builder()
                .setRequested(true)
                .build()
            )
            .build()
        )
        .setIntraStripeFlows(
          FinancialAccountCreateParams.Features.IntraStripeFlows.builder()
            .setRequested(true)
            .build()
        )
        .setOutboundPayments(
          FinancialAccountCreateParams.Features.OutboundPayments.builder()
            .setAch(
              FinancialAccountCreateParams.Features.OutboundPayments.Ach.builder()
                .setRequested(true)
                .build()
            )
            .setUsDomesticWire(
              FinancialAccountCreateParams.Features.OutboundPayments.UsDomesticWire.builder()
                .setRequested(true)
                .build()
            )
            .build()
        )
        .setOutboundTransfers(
          FinancialAccountCreateParams.Features.OutboundTransfers.builder()
            .setAch(
              FinancialAccountCreateParams.Features.OutboundTransfers.Ach.builder()
                .setRequested(true)
                .build()
            )
            .setUsDomesticWire(
              FinancialAccountCreateParams.Features.OutboundTransfers.UsDomesticWire.builder()
                .setRequested(true)
                .build()
            )
            .build()
        )
        .build()
    )
    .putExtraParam("features[card_issuing][requested]", true)
    .build();

RequestOptions requestOptions =
  RequestOptions.builder().setStripeAccount("{{CONNECTEDACCOUNT_ID}}").build();

FinancialAccount financialAccount = FinancialAccount.create(params, requestOptions);
```

```java
// Set your secret key. Remember to switch to your live secret key in production.
// See your keys here: https://dashboard.stripe.com/apikeys
StripeClient client = new StripeClient("<<YOUR_SECRET_KEY>>");

FinancialAccountCreateParams params =
  FinancialAccountCreateParams.builder()
    .addSupportedCurrency("usd")
    .setNickname("{{OPTIONAL_NICKNAME}}")
    .setFeatures(
      FinancialAccountCreateParams.Features.builder()
        .setDepositInsurance(
          FinancialAccountCreateParams.Features.DepositInsurance.builder()
            .setRequested(true)
            .build()
        )
        .setFinancialAddresses(
          FinancialAccountCreateParams.Features.FinancialAddresses.builder()
            .setAba(
              FinancialAccountCreateParams.Features.FinancialAddresses.Aba.builder()
                .setRequested(true)
                .build()
            )
            .build()
        )
        .setInboundTransfers(
          FinancialAccountCreateParams.Features.InboundTransfers.builder()
            .setAch(
              FinancialAccountCreateParams.Features.InboundTransfers.Ach.builder()
                .setRequested(true)
                .build()
            )
            .build()
        )
        .setIntraStripeFlows(
          FinancialAccountCreateParams.Features.IntraStripeFlows.builder()
            .setRequested(true)
            .build()
        )
        .setOutboundPayments(
          FinancialAccountCreateParams.Features.OutboundPayments.builder()
            .setAch(
              FinancialAccountCreateParams.Features.OutboundPayments.Ach.builder()
                .setRequested(true)
                .build()
            )
            .setUsDomesticWire(
              FinancialAccountCreateParams.Features.OutboundPayments.UsDomesticWire.builder()
                .setRequested(true)
                .build()
            )
            .build()
        )
        .setOutboundTransfers(
          FinancialAccountCreateParams.Features.OutboundTransfers.builder()
            .setAch(
              FinancialAccountCreateParams.Features.OutboundTransfers.Ach.builder()
                .setRequested(true)
                .build()
            )
            .setUsDomesticWire(
              FinancialAccountCreateParams.Features.OutboundTransfers.UsDomesticWire.builder()
                .setRequested(true)
                .build()
            )
            .build()
        )
        .build()
    )
    .putExtraParam("features[card_issuing][requested]", true)
    .build();

RequestOptions requestOptions =
  RequestOptions.builder().setStripeAccount("{{CONNECTEDACCOUNT_ID}}").build();
// For SDK versions 29.4.0 or lower, remove '.v1()' from the following line.

FinancialAccount financialAccount =
  client.v1().treasury().financialAccounts().create(params, requestOptions);
```

```node
// Set your secret key. Remember to switch to your live secret key in production.
// See your keys here: https://dashboard.stripe.com/apikeys
const stripe = require('stripe')('<<YOUR_SECRET_KEY>>');

const financialAccount = await stripe.treasury.financialAccounts.create(
  {
    supported_currencies: ['usd'],
    nickname: '{{OPTIONAL_NICKNAME}}',
    features: {
      card_issuing: {
        requested: true,
      },
      deposit_insurance: {
        requested: true,
      },
      financial_addresses: {
        aba: {
          requested: true,
        },
      },
      inbound_transfers: {
        ach: {
          requested: true,
        },
      },
      intra_stripe_flows: {
        requested: true,
      },
      outbound_payments: {
        ach: {
          requested: true,
        },
        us_domestic_wire: {
          requested: true,
        },
      },
      outbound_transfers: {
        ach: {
          requested: true,
        },
        us_domestic_wire: {
          requested: true,
        },
      },
    },
  },
  {
    stripeAccount: '{{CONNECTEDACCOUNT_ID}}',
  }
);
```

```go
// Set your secret key. Remember to switch to your live secret key in production.
// See your keys here: https://dashboard.stripe.com/apikeys
stripe.Key = "<<YOUR_SECRET_KEY>>"

params := &stripe.TreasuryFinancialAccountParams{
  SupportedCurrencies: []*string{stripe.String("usd")},
  Nickname: stripe.String("{{OPTIONAL_NICKNAME}}"),
  Features: &stripe.TreasuryFinancialAccountFeaturesParams{
    DepositInsurance: &stripe.TreasuryFinancialAccountFeaturesDepositInsuranceParams{
      Requested: stripe.Bool(true),
    },
    FinancialAddresses: &stripe.TreasuryFinancialAccountFeaturesFinancialAddressesParams{
      ABA: &stripe.TreasuryFinancialAccountFeaturesFinancialAddressesABAParams{
        Requested: stripe.Bool(true),
      },
    },
    InboundTransfers: &stripe.TreasuryFinancialAccountFeaturesInboundTransfersParams{
      ACH: &stripe.TreasuryFinancialAccountFeaturesInboundTransfersACHParams{
        Requested: stripe.Bool(true),
      },
    },
    IntraStripeFlows: &stripe.TreasuryFinancialAccountFeaturesIntraStripeFlowsParams{
      Requested: stripe.Bool(true),
    },
    OutboundPayments: &stripe.TreasuryFinancialAccountFeaturesOutboundPaymentsParams{
      ACH: &stripe.TreasuryFinancialAccountFeaturesOutboundPaymentsACHParams{
        Requested: stripe.Bool(true),
      },
      USDomesticWire: &stripe.TreasuryFinancialAccountFeaturesOutboundPaymentsUSDomesticWireParams{
        Requested: stripe.Bool(true),
      },
    },
    OutboundTransfers: &stripe.TreasuryFinancialAccountFeaturesOutboundTransfersParams{
      ACH: &stripe.TreasuryFinancialAccountFeaturesOutboundTransfersACHParams{
        Requested: stripe.Bool(true),
      },
      USDomesticWire: &stripe.TreasuryFinancialAccountFeaturesOutboundTransfersUSDomesticWireParams{
        Requested: stripe.Bool(true),
      },
    },
  },
}
params.AddExtra("features[card_issuing][requested]", true)
params.SetStripeAccount("{{CONNECTEDACCOUNT_ID}}")
result, err := financialaccount.New(params)
```

```go
// Set your secret key. Remember to switch to your live secret key in production.
// See your keys here: https://dashboard.stripe.com/apikeys
sc := stripe.NewClient("<<YOUR_SECRET_KEY>>")
params := &stripe.TreasuryFinancialAccountCreateParams{
  SupportedCurrencies: []*string{stripe.String("usd")},
  Nickname: stripe.String("{{OPTIONAL_NICKNAME}}"),
  Features: &stripe.TreasuryFinancialAccountCreateFeaturesParams{
    DepositInsurance: &stripe.TreasuryFinancialAccountCreateFeaturesDepositInsuranceParams{
      Requested: stripe.Bool(true),
    },
    FinancialAddresses: &stripe.TreasuryFinancialAccountCreateFeaturesFinancialAddressesParams{
      ABA: &stripe.TreasuryFinancialAccountCreateFeaturesFinancialAddressesABAParams{
        Requested: stripe.Bool(true),
      },
    },
    InboundTransfers: &stripe.TreasuryFinancialAccountCreateFeaturesInboundTransfersParams{
      ACH: &stripe.TreasuryFinancialAccountCreateFeaturesInboundTransfersACHParams{
        Requested: stripe.Bool(true),
      },
    },
    IntraStripeFlows: &stripe.TreasuryFinancialAccountCreateFeaturesIntraStripeFlowsParams{
      Requested: stripe.Bool(true),
    },
    OutboundPayments: &stripe.TreasuryFinancialAccountCreateFeaturesOutboundPaymentsParams{
      ACH: &stripe.TreasuryFinancialAccountCreateFeaturesOutboundPaymentsACHParams{
        Requested: stripe.Bool(true),
      },
      USDomesticWire: &stripe.TreasuryFinancialAccountCreateFeaturesOutboundPaymentsUSDomesticWireParams{
        Requested: stripe.Bool(true),
      },
    },
    OutboundTransfers: &stripe.TreasuryFinancialAccountCreateFeaturesOutboundTransfersParams{
      ACH: &stripe.TreasuryFinancialAccountCreateFeaturesOutboundTransfersACHParams{
        Requested: stripe.Bool(true),
      },
      USDomesticWire: &stripe.TreasuryFinancialAccountCreateFeaturesOutboundTransfersUSDomesticWireParams{
        Requested: stripe.Bool(true),
      },
    },
  },
}
params.AddExtra("features[card_issuing][requested]", true)
params.SetStripeAccount("{{CONNECTEDACCOUNT_ID}}")
result, err := sc.V1TreasuryFinancialAccounts.Create(context.TODO(), params)
```

```dotnet
// Set your secret key. Remember to switch to your live secret key in production.
// See your keys here: https://dashboard.stripe.com/apikeys
StripeConfiguration.ApiKey = "<<YOUR_SECRET_KEY>>";

var options = new Stripe.Treasury.FinancialAccountCreateOptions
{
    SupportedCurrencies = new List<string> { "usd" },
    Nickname = "{{OPTIONAL_NICKNAME}}",
    Features = new Stripe.Treasury.FinancialAccountFeaturesOptions
    {
        CardIssuing = new Stripe.Treasury.FinancialAccountFeaturesCardIssuingOptions
        {
            Requested = true,
        },
        DepositInsurance = new Stripe.Treasury.FinancialAccountFeaturesDepositInsuranceOptions
        {
            Requested = true,
        },
        FinancialAddresses = new Stripe.Treasury.FinancialAccountFeaturesFinancialAddressesOptions
        {
            Aba = new Stripe.Treasury.FinancialAccountFeaturesFinancialAddressesAbaOptions
            {
                Requested = true,
            },
        },
        InboundTransfers = new Stripe.Treasury.FinancialAccountFeaturesInboundTransfersOptions
        {
            Ach = new Stripe.Treasury.FinancialAccountFeaturesInboundTransfersAchOptions
            {
                Requested = true,
            },
        },
        IntraStripeFlows = new Stripe.Treasury.FinancialAccountFeaturesIntraStripeFlowsOptions
        {
            Requested = true,
        },
        OutboundPayments = new Stripe.Treasury.FinancialAccountFeaturesOutboundPaymentsOptions
        {
            Ach = new Stripe.Treasury.FinancialAccountFeaturesOutboundPaymentsAchOptions
            {
                Requested = true,
            },
            UsDomesticWire = new Stripe.Treasury.FinancialAccountFeaturesOutboundPaymentsUsDomesticWireOptions
            {
                Requested = true,
            },
        },
        OutboundTransfers = new Stripe.Treasury.FinancialAccountFeaturesOutboundTransfersOptions
        {
            Ach = new Stripe.Treasury.FinancialAccountFeaturesOutboundTransfersAchOptions
            {
                Requested = true,
            },
            UsDomesticWire = new Stripe.Treasury.FinancialAccountFeaturesOutboundTransfersUsDomesticWireOptions
            {
                Requested = true,
            },
        },
    },
};
var requestOptions = new RequestOptions
{
    StripeAccount = "{{CONNECTEDACCOUNT_ID}}",
};
var service = new Stripe.Treasury.FinancialAccountService();
Stripe.Treasury.FinancialAccount financialAccount = service.Create(
    options,
    requestOptions);
```

```dotnet
// Set your secret key. Remember to switch to your live secret key in production.
// See your keys here: https://dashboard.stripe.com/apikeys
var options = new Stripe.Treasury.FinancialAccountCreateOptions
{
    SupportedCurrencies = new List<string> { "usd" },
    Nickname = "{{OPTIONAL_NICKNAME}}",
    Features = new Stripe.Treasury.FinancialAccountFeaturesOptions
    {
        CardIssuing = new Stripe.Treasury.FinancialAccountFeaturesCardIssuingOptions
        {
            Requested = true,
        },
        DepositInsurance = new Stripe.Treasury.FinancialAccountFeaturesDepositInsuranceOptions
        {
            Requested = true,
        },
        FinancialAddresses = new Stripe.Treasury.FinancialAccountFeaturesFinancialAddressesOptions
        {
            Aba = new Stripe.Treasury.FinancialAccountFeaturesFinancialAddressesAbaOptions
            {
                Requested = true,
            },
        },
        InboundTransfers = new Stripe.Treasury.FinancialAccountFeaturesInboundTransfersOptions
        {
            Ach = new Stripe.Treasury.FinancialAccountFeaturesInboundTransfersAchOptions
            {
                Requested = true,
            },
        },
        IntraStripeFlows = new Stripe.Treasury.FinancialAccountFeaturesIntraStripeFlowsOptions
        {
            Requested = true,
        },
        OutboundPayments = new Stripe.Treasury.FinancialAccountFeaturesOutboundPaymentsOptions
        {
            Ach = new Stripe.Treasury.FinancialAccountFeaturesOutboundPaymentsAchOptions
            {
                Requested = true,
            },
            UsDomesticWire = new Stripe.Treasury.FinancialAccountFeaturesOutboundPaymentsUsDomesticWireOptions
            {
                Requested = true,
            },
        },
        OutboundTransfers = new Stripe.Treasury.FinancialAccountFeaturesOutboundTransfersOptions
        {
            Ach = new Stripe.Treasury.FinancialAccountFeaturesOutboundTransfersAchOptions
            {
                Requested = true,
            },
            UsDomesticWire = new Stripe.Treasury.FinancialAccountFeaturesOutboundTransfersUsDomesticWireOptions
            {
                Requested = true,
            },
        },
    },
};
var requestOptions = new RequestOptions
{
    StripeAccount = "{{CONNECTEDACCOUNT_ID}}",
};
var client = new StripeClient("<<YOUR_SECRET_KEY>>");
var service = client.V1.Treasury.FinancialAccounts;
Stripe.Treasury.FinancialAccount financialAccount = service.Create(
    options,
    requestOptions);
```

The response is a `FinancialAccount` object to confirm financial account creation.

```json
{
  "object": "treasury.financial_account",
  "created": 1612927106,
  "id": "{{FINANCIAL_ACCOUNT_ID}}",
  "country": "US",
  "supported_currencies": ["usd"],
  "active_features": [
    "card_issuing",
  ],
  // Features that require activation enter a pending state before activating
  "pending_features": [
    "deposit_insurance",
    "financial_addresses.aba",
    "inbound_transfers.ach",
    "intra_stripe_flows",
    "outbound_payments.ach",
    "outbound_payments.us_domestic_wire",
    "outbound_transfers.ach",
    "outbound_transfers.us_domestic_wire"
  ],
  "restricted_features": [],
  // A FinancialAddress is not added until the financial_addresses.aba feature has been activated
  "financial_addresses": [],
  "livemode": true,
  "nickname": "{{ACCOUNT_NICKNAME}}",
  "status": "open",
  ...
}
```

## Update a FinancialAccount

Use `POST /v1/treasury/financial_accounts/{{FINANCIAL_ACCOUNT_ID}}` to update the `FinancialAccount` with the associated ID. Include the connected account ID as the `Stripe-Account` header value. The following example updates the [metadata](https://docs.stripe.com/api/metadata.md) of the FinancialAccount.

```curl
curl https://api.stripe.com/v1/treasury/financial_accounts/{{TREASURYFINANCIALACCOUNT_ID}} \
  -u "<<YOUR_SECRET_KEY>>:" \
  -H "Stripe-Account: {{CONNECTEDACCOUNT_ID}}" \
  -d "metadata[key]"=value
```

```cli
stripe treasury financial_accounts update {{TREASURYFINANCIALACCOUNT_ID}} \
  --stripe-account {{CONNECTEDACCOUNT_ID}} \
  -d "metadata[key]"=value
```

```ruby
# Set your secret key. Remember to switch to your live secret key in production.
# See your keys here: https://dashboard.stripe.com/apikeys
Stripe.api_key = '<<YOUR_SECRET_KEY>>'

financial_account = Stripe::Treasury::FinancialAccount.update(
  '{{TREASURYFINANCIALACCOUNT_ID}}',
  {metadata: {key: 'value'}},
  {stripe_account: '{{CONNECTEDACCOUNT_ID}}'},
)
```

```ruby
# Set your secret key. Remember to switch to your live secret key in production.
# See your keys here: https://dashboard.stripe.com/apikeys
client = Stripe::StripeClient.new("<<YOUR_SECRET_KEY>>")

financial_account = client.v1.treasury.financial_accounts.update(
  '{{TREASURYFINANCIALACCOUNT_ID}}',
  {metadata: {key: 'value'}},
  {stripe_account: '{{CONNECTEDACCOUNT_ID}}'},
)
```

```python
# Set your secret key. Remember to switch to your live secret key in production.
# See your keys here: https://dashboard.stripe.com/apikeys
import stripe
stripe.api_key = "<<YOUR_SECRET_KEY>>"

financial_account = stripe.treasury.FinancialAccount.modify(
  "{{TREASURYFINANCIALACCOUNT_ID}}",
  metadata={"key": "value"},
  stripe_account="{{CONNECTEDACCOUNT_ID}}",
)
```

```python
# Set your secret key. Remember to switch to your live secret key in production.
# See your keys here: https://dashboard.stripe.com/apikeys
client = StripeClient("<<YOUR_SECRET_KEY>>")

# For SDK versions 12.4.0 or lower, remove '.v1' from the following line.
financial_account = client.v1.treasury.financial_accounts.update(
  "{{TREASURYFINANCIALACCOUNT_ID}}",
  {"metadata": {"key": "value"}},
  {"stripe_account": "{{CONNECTEDACCOUNT_ID}}"},
)
```

```php
// Set your secret key. Remember to switch to your live secret key in production.
// See your keys here: https://dashboard.stripe.com/apikeys
$stripe = new \Stripe\StripeClient('<<YOUR_SECRET_KEY>>');

$financialAccount = $stripe->treasury->financialAccounts->update(
  '{{TREASURYFINANCIALACCOUNT_ID}}',
  ['metadata' => ['key' => 'value']],
  ['stripe_account' => '{{CONNECTEDACCOUNT_ID}}']
);
```

```java
// Set your secret key. Remember to switch to your live secret key in production.
// See your keys here: https://dashboard.stripe.com/apikeys
Stripe.apiKey = "<<YOUR_SECRET_KEY>>";

FinancialAccount resource =
  FinancialAccount.retrieve("{{TREASURYFINANCIALACCOUNT_ID}}");

FinancialAccountUpdateParams params =
  FinancialAccountUpdateParams.builder().putMetadata("key", "value").build();

RequestOptions requestOptions =
  RequestOptions.builder().setStripeAccount("{{CONNECTEDACCOUNT_ID}}").build();

FinancialAccount financialAccount = resource.update(params, requestOptions);
```

```java
// Set your secret key. Remember to switch to your live secret key in production.
// See your keys here: https://dashboard.stripe.com/apikeys
StripeClient client = new StripeClient("<<YOUR_SECRET_KEY>>");

FinancialAccountUpdateParams params =
  FinancialAccountUpdateParams.builder().putMetadata("key", "value").build();

RequestOptions requestOptions =
  RequestOptions.builder().setStripeAccount("{{CONNECTEDACCOUNT_ID}}").build();
// For SDK versions 29.4.0 or lower, remove '.v1()' from the following line.

FinancialAccount financialAccount =
  client.v1().treasury().financialAccounts().update(
    "{{TREASURYFINANCIALACCOUNT_ID}}",
    params,
    requestOptions
  );
```

```node
// Set your secret key. Remember to switch to your live secret key in production.
// See your keys here: https://dashboard.stripe.com/apikeys
const stripe = require('stripe')('<<YOUR_SECRET_KEY>>');

const financialAccount = await stripe.treasury.financialAccounts.update(
  '{{TREASURYFINANCIALACCOUNT_ID}}',
  {
    metadata: {
      key: 'value',
    },
  },
  {
    stripeAccount: '{{CONNECTEDACCOUNT_ID}}',
  }
);
```

```go
// Set your secret key. Remember to switch to your live secret key in production.
// See your keys here: https://dashboard.stripe.com/apikeys
stripe.Key = "<<YOUR_SECRET_KEY>>"

params := &stripe.TreasuryFinancialAccountParams{}
params.AddMetadata("key", "value")
params.SetStripeAccount("{{CONNECTEDACCOUNT_ID}}")
result, err := financialaccount.Update("{{TREASURYFINANCIALACCOUNT_ID}}", params)
```

```go
// Set your secret key. Remember to switch to your live secret key in production.
// See your keys here: https://dashboard.stripe.com/apikeys
sc := stripe.NewClient("<<YOUR_SECRET_KEY>>")
params := &stripe.TreasuryFinancialAccountUpdateParams{
  FinancialAccount: stripe.String("{{TREASURYFINANCIALACCOUNT_ID}}"),
}
params.AddMetadata("key", "value")
params.SetStripeAccount("{{CONNECTEDACCOUNT_ID}}")
result, err := sc.V1TreasuryFinancialAccounts.Update(context.TODO(), params)
```

```dotnet
// Set your secret key. Remember to switch to your live secret key in production.
// See your keys here: https://dashboard.stripe.com/apikeys
StripeConfiguration.ApiKey = "<<YOUR_SECRET_KEY>>";

var options = new Stripe.Treasury.FinancialAccountUpdateOptions
{
    Metadata = new Dictionary<string, string> { { "key", "value" } },
};
var requestOptions = new RequestOptions
{
    StripeAccount = "{{CONNECTEDACCOUNT_ID}}",
};
var service = new Stripe.Treasury.FinancialAccountService();
Stripe.Treasury.FinancialAccount financialAccount = service.Update(
    "{{TREASURYFINANCIALACCOUNT_ID}}",
    options,
    requestOptions);
```

```dotnet
// Set your secret key. Remember to switch to your live secret key in production.
// See your keys here: https://dashboard.stripe.com/apikeys
var options = new Stripe.Treasury.FinancialAccountUpdateOptions
{
    Metadata = new Dictionary<string, string> { { "key", "value" } },
};
var requestOptions = new RequestOptions
{
    StripeAccount = "{{CONNECTEDACCOUNT_ID}}",
};
var client = new StripeClient("<<YOUR_SECRET_KEY>>");
var service = client.V1.Treasury.FinancialAccounts;
Stripe.Treasury.FinancialAccount financialAccount = service.Update(
    "{{TREASURYFINANCIALACCOUNT_ID}}",
    options,
    requestOptions);
```

## Retrieve a FinancialAccount and account number

Use `GET /v1/treasury/financial_accounts/{{FINANCIALACCOUNT_ID}}` to retrieve the `FinancialAccount` with the associated ID. Include the connected account ID as the `Stripe-Account` header value.

```curl
curl https://api.stripe.com/v1/treasury/financial_accounts/{{TREASURYFINANCIALACCOUNT_ID}} \
  -u "<<YOUR_SECRET_KEY>>:" \
  -H "Stripe-Account: {{CONNECTEDACCOUNT_ID}}"
```

```cli
stripe treasury financial_accounts retrieve {{TREASURYFINANCIALACCOUNT_ID}} \
  --stripe-account {{CONNECTEDACCOUNT_ID}}
```

```ruby
# Set your secret key. Remember to switch to your live secret key in production.
# See your keys here: https://dashboard.stripe.com/apikeys
Stripe.api_key = '<<YOUR_SECRET_KEY>>'

financial_account = Stripe::Treasury::FinancialAccount.retrieve(
  '{{TREASURYFINANCIALACCOUNT_ID}}',
  {stripe_account: '{{CONNECTEDACCOUNT_ID}}'},
)
```

```ruby
# Set your secret key. Remember to switch to your live secret key in production.
# See your keys here: https://dashboard.stripe.com/apikeys
client = Stripe::StripeClient.new("<<YOUR_SECRET_KEY>>")

financial_account = client.v1.treasury.financial_accounts.retrieve(
  '{{TREASURYFINANCIALACCOUNT_ID}}',
  {},
  {stripe_account: '{{CONNECTEDACCOUNT_ID}}'},
)
```

```python
# Set your secret key. Remember to switch to your live secret key in production.
# See your keys here: https://dashboard.stripe.com/apikeys
import stripe
stripe.api_key = "<<YOUR_SECRET_KEY>>"

financial_account = stripe.treasury.FinancialAccount.retrieve(
  "{{TREASURYFINANCIALACCOUNT_ID}}",
  stripe_account="{{CONNECTEDACCOUNT_ID}}",
)
```

```python
# Set your secret key. Remember to switch to your live secret key in production.
# See your keys here: https://dashboard.stripe.com/apikeys
client = StripeClient("<<YOUR_SECRET_KEY>>")

# For SDK versions 12.4.0 or lower, remove '.v1' from the following line.
financial_account = client.v1.treasury.financial_accounts.retrieve(
  "{{TREASURYFINANCIALACCOUNT_ID}}",
  options={"stripe_account": "{{CONNECTEDACCOUNT_ID}}"},
)
```

```php
// Set your secret key. Remember to switch to your live secret key in production.
// See your keys here: https://dashboard.stripe.com/apikeys
$stripe = new \Stripe\StripeClient('<<YOUR_SECRET_KEY>>');

$financialAccount = $stripe->treasury->financialAccounts->retrieve(
  '{{TREASURYFINANCIALACCOUNT_ID}}',
  [],
  ['stripe_account' => '{{CONNECTEDACCOUNT_ID}}']
);
```

```java
// Set your secret key. Remember to switch to your live secret key in production.
// See your keys here: https://dashboard.stripe.com/apikeys
Stripe.apiKey = "<<YOUR_SECRET_KEY>>";

RequestOptions requestOptions =
  RequestOptions.builder().setStripeAccount("{{CONNECTEDACCOUNT_ID}}").build();

FinancialAccount financialAccount =
  FinancialAccount.retrieve("{{TREASURYFINANCIALACCOUNT_ID}}", requestOptions);
```

```java
// Set your secret key. Remember to switch to your live secret key in production.
// See your keys here: https://dashboard.stripe.com/apikeys
StripeClient client = new StripeClient("<<YOUR_SECRET_KEY>>");

FinancialAccountRetrieveParams params = FinancialAccountRetrieveParams.builder().build();

RequestOptions requestOptions =
  RequestOptions.builder().setStripeAccount("{{CONNECTEDACCOUNT_ID}}").build();
// For SDK versions 29.4.0 or lower, remove '.v1()' from the following line.

FinancialAccount financialAccount =
  client.v1().treasury().financialAccounts().retrieve(
    "{{TREASURYFINANCIALACCOUNT_ID}}",
    params,
    requestOptions
  );
```

```node
// Set your secret key. Remember to switch to your live secret key in production.
// See your keys here: https://dashboard.stripe.com/apikeys
const stripe = require('stripe')('<<YOUR_SECRET_KEY>>');

const financialAccount = await stripe.treasury.financialAccounts.retrieve(
  '{{TREASURYFINANCIALACCOUNT_ID}}',
  {
    stripeAccount: '{{CONNECTEDACCOUNT_ID}}',
  }
);
```

```go
// Set your secret key. Remember to switch to your live secret key in production.
// See your keys here: https://dashboard.stripe.com/apikeys
stripe.Key = "<<YOUR_SECRET_KEY>>"

params := &stripe.TreasuryFinancialAccountParams{}
params.SetStripeAccount("{{CONNECTEDACCOUNT_ID}}")
result, err := financialaccount.Get("{{TREASURYFINANCIALACCOUNT_ID}}", params)
```

```go
// Set your secret key. Remember to switch to your live secret key in production.
// See your keys here: https://dashboard.stripe.com/apikeys
sc := stripe.NewClient("<<YOUR_SECRET_KEY>>")
params := &stripe.TreasuryFinancialAccountRetrieveParams{
  FinancialAccount: stripe.String("{{TREASURYFINANCIALACCOUNT_ID}}"),
}
params.SetStripeAccount("{{CONNECTEDACCOUNT_ID}}")
result, err := sc.V1TreasuryFinancialAccounts.Retrieve(context.TODO(), params)
```

```dotnet
// Set your secret key. Remember to switch to your live secret key in production.
// See your keys here: https://dashboard.stripe.com/apikeys
StripeConfiguration.ApiKey = "<<YOUR_SECRET_KEY>>";

var requestOptions = new RequestOptions
{
    StripeAccount = "{{CONNECTEDACCOUNT_ID}}",
};
var service = new Stripe.Treasury.FinancialAccountService();
Stripe.Treasury.FinancialAccount financialAccount = service.Get(
    "{{TREASURYFINANCIALACCOUNT_ID}}",
    null,
    requestOptions);
```

```dotnet
// Set your secret key. Remember to switch to your live secret key in production.
// See your keys here: https://dashboard.stripe.com/apikeys
var requestOptions = new RequestOptions
{
    StripeAccount = "{{CONNECTEDACCOUNT_ID}}",
};
var client = new StripeClient("<<YOUR_SECRET_KEY>>");
var service = client.V1.Treasury.FinancialAccounts;
Stripe.Treasury.FinancialAccount financialAccount = service.Get(
    "{{TREASURYFINANCIALACCOUNT_ID}}",
    null,
    requestOptions);
```

By default, the account number for a financial account isn’t included in the response. To retrieve the account number, include the `financial_addresses.aba.account_number` field in the `expand` array.

```curl
curl -G https://api.stripe.com/v1/treasury/financial_accounts/{{TREASURYFINANCIALACCOUNT_ID}} \
  -u "<<YOUR_SECRET_KEY>>:" \
  -H "Stripe-Account: {{CONNECTEDACCOUNT_ID}}" \
  -d "expand[]"="financial_addresses.aba.account_number"
```

```cli
stripe treasury financial_accounts retrieve {{TREASURYFINANCIALACCOUNT_ID}} \
  --stripe-account {{CONNECTEDACCOUNT_ID}} \
  -d "expand[0]"="financial_addresses.aba.account_number"
```

```ruby
# Set your secret key. Remember to switch to your live secret key in production.
# See your keys here: https://dashboard.stripe.com/apikeys
Stripe.api_key = '<<YOUR_SECRET_KEY>>'

financial_account = Stripe::Treasury::FinancialAccount.retrieve(
  {
    expand: ['financial_addresses.aba.account_number'],
    id: '{{TREASURYFINANCIALACCOUNT_ID}}',
  },
  {stripe_account: '{{CONNECTEDACCOUNT_ID}}'},
)
```

```ruby
# Set your secret key. Remember to switch to your live secret key in production.
# See your keys here: https://dashboard.stripe.com/apikeys
client = Stripe::StripeClient.new("<<YOUR_SECRET_KEY>>")

financial_account = client.v1.treasury.financial_accounts.retrieve(
  '{{TREASURYFINANCIALACCOUNT_ID}}',
  {expand: ['financial_addresses.aba.account_number']},
  {stripe_account: '{{CONNECTEDACCOUNT_ID}}'},
)
```

```python
# Set your secret key. Remember to switch to your live secret key in production.
# See your keys here: https://dashboard.stripe.com/apikeys
import stripe
stripe.api_key = "<<YOUR_SECRET_KEY>>"

financial_account = stripe.treasury.FinancialAccount.retrieve(
  "{{TREASURYFINANCIALACCOUNT_ID}}",
  expand=["financial_addresses.aba.account_number"],
  stripe_account="{{CONNECTEDACCOUNT_ID}}",
)
```

```python
# Set your secret key. Remember to switch to your live secret key in production.
# See your keys here: https://dashboard.stripe.com/apikeys
client = StripeClient("<<YOUR_SECRET_KEY>>")

# For SDK versions 12.4.0 or lower, remove '.v1' from the following line.
financial_account = client.v1.treasury.financial_accounts.retrieve(
  "{{TREASURYFINANCIALACCOUNT_ID}}",
  {"expand": ["financial_addresses.aba.account_number"]},
  {"stripe_account": "{{CONNECTEDACCOUNT_ID}}"},
)
```

```php
// Set your secret key. Remember to switch to your live secret key in production.
// See your keys here: https://dashboard.stripe.com/apikeys
$stripe = new \Stripe\StripeClient('<<YOUR_SECRET_KEY>>');

$financialAccount = $stripe->treasury->financialAccounts->retrieve(
  '{{TREASURYFINANCIALACCOUNT_ID}}',
  ['expand' => ['financial_addresses.aba.account_number']],
  ['stripe_account' => '{{CONNECTEDACCOUNT_ID}}']
);
```

```java
// Set your secret key. Remember to switch to your live secret key in production.
// See your keys here: https://dashboard.stripe.com/apikeys
Stripe.apiKey = "<<YOUR_SECRET_KEY>>";

FinancialAccountRetrieveParams params =
  FinancialAccountRetrieveParams.builder()
    .addExpand("financial_addresses.aba.account_number")
    .build();

RequestOptions requestOptions =
  RequestOptions.builder().setStripeAccount("{{CONNECTEDACCOUNT_ID}}").build();

FinancialAccount financialAccount =
  FinancialAccount.retrieve(
    "{{TREASURYFINANCIALACCOUNT_ID}}",
    params,
    null,
    requestOptions
  );
```

```java
// Set your secret key. Remember to switch to your live secret key in production.
// See your keys here: https://dashboard.stripe.com/apikeys
StripeClient client = new StripeClient("<<YOUR_SECRET_KEY>>");

FinancialAccountRetrieveParams params =
  FinancialAccountRetrieveParams.builder()
    .addExpand("financial_addresses.aba.account_number")
    .build();

RequestOptions requestOptions =
  RequestOptions.builder().setStripeAccount("{{CONNECTEDACCOUNT_ID}}").build();
// For SDK versions 29.4.0 or lower, remove '.v1()' from the following line.

FinancialAccount financialAccount =
  client.v1().treasury().financialAccounts().retrieve(
    "{{TREASURYFINANCIALACCOUNT_ID}}",
    params,
    requestOptions
  );
```

```node
// Set your secret key. Remember to switch to your live secret key in production.
// See your keys here: https://dashboard.stripe.com/apikeys
const stripe = require('stripe')('<<YOUR_SECRET_KEY>>');

const financialAccount = await stripe.treasury.financialAccounts.retrieve(
  '{{TREASURYFINANCIALACCOUNT_ID}}',
  {
    expand: ['financial_addresses.aba.account_number'],
  },
  {
    stripeAccount: '{{CONNECTEDACCOUNT_ID}}',
  }
);
```

```go
// Set your secret key. Remember to switch to your live secret key in production.
// See your keys here: https://dashboard.stripe.com/apikeys
stripe.Key = "<<YOUR_SECRET_KEY>>"

params := &stripe.TreasuryFinancialAccountParams{}
params.AddExpand("financial_addresses.aba.account_number")
params.SetStripeAccount("{{CONNECTEDACCOUNT_ID}}")
result, err := financialaccount.Get("{{TREASURYFINANCIALACCOUNT_ID}}", params)
```

```go
// Set your secret key. Remember to switch to your live secret key in production.
// See your keys here: https://dashboard.stripe.com/apikeys
sc := stripe.NewClient("<<YOUR_SECRET_KEY>>")
params := &stripe.TreasuryFinancialAccountRetrieveParams{
  FinancialAccount: stripe.String("{{TREASURYFINANCIALACCOUNT_ID}}"),
}
params.AddExpand("financial_addresses.aba.account_number")
params.SetStripeAccount("{{CONNECTEDACCOUNT_ID}}")
result, err := sc.V1TreasuryFinancialAccounts.Retrieve(context.TODO(), params)
```

```dotnet
// Set your secret key. Remember to switch to your live secret key in production.
// See your keys here: https://dashboard.stripe.com/apikeys
StripeConfiguration.ApiKey = "<<YOUR_SECRET_KEY>>";

var options = new Stripe.Treasury.FinancialAccountGetOptions
{
    Expand = new List<string> { "financial_addresses.aba.account_number" },
};
var requestOptions = new RequestOptions
{
    StripeAccount = "{{CONNECTEDACCOUNT_ID}}",
};
var service = new Stripe.Treasury.FinancialAccountService();
Stripe.Treasury.FinancialAccount financialAccount = service.Get(
    "{{TREASURYFINANCIALACCOUNT_ID}}",
    options,
    requestOptions);
```

```dotnet
// Set your secret key. Remember to switch to your live secret key in production.
// See your keys here: https://dashboard.stripe.com/apikeys
var options = new Stripe.Treasury.FinancialAccountGetOptions
{
    Expand = new List<string> { "financial_addresses.aba.account_number" },
};
var requestOptions = new RequestOptions
{
    StripeAccount = "{{CONNECTEDACCOUNT_ID}}",
};
var client = new StripeClient("<<YOUR_SECRET_KEY>>");
var service = client.V1.Treasury.FinancialAccounts;
Stripe.Treasury.FinancialAccount financialAccount = service.Get(
    "{{TREASURYFINANCIALACCOUNT_ID}}",
    options,
    requestOptions);
```

If successful, the response returns the `FinancialAccount` object with or without the account number depending on the inclusion of the `expand` array.

#### Response with account expanded

```json
{
  "id": {{FINANCIAL_ACCOUNT_ID}},
  ...
  "financial_addresses": [
    {
      "aba": {
        "account_holder_name": "jenny",
        "account_number": "4242424242420239",
        "account_number_last4": "0239",
        "bank_name": "Stripe Test Bank",
        "routing_number": "000000001"
      },
      ...
    }
  ],
  ...
}
```

#### Default response

```json
{
  "id": {{FINANCIAL_ACCOUNT_ID}},
  ...
  "financial_addresses": [
    {
      "aba": {
        "account_holder_name": "jenny",
        "account_number_last4": "0239",
        "bank_name": "Stripe Test Bank",
        "routing_number": "000000001"
      },
      ...
    }
  ],
  ...
}
```

For more information on the `expand` parameter, see [expanding responses](https://docs.stripe.com/expand.md).

### Feature summary

The `FinancialAccount` object contains a summary of the state of all its `Features` in three arrays - `active_features`, `pending_features`, and `restricted_features`.

```json
{
  "object": "treasury.financial_account",
  "id": "fa_987",
  "status": "open",
  ...
  "active_features": ["card_issuing"],
  "pending_features": ["financial_addresses.aba"],
  "restricted_features": ["outbound_transfers.ach"],
}
```

These arrays provide a convenient way to see:

- Inactive features (included in `pending_features` or `restricted_features`)
- Active features (included in `active_features`)
- Restricted features that require action (included in `restricted_features`)

See [Financial account features](https://docs.stripe.com/treasury/account-management/financial-account-features.md) for more information.

## Close a FinancialAccount

You can permanently close a financial account if it meets the following conditions:

- There are no pending inbound transfers.
- All attached Issuing cards are canceled.
- The account balance is zero and the account has no activity in the past 75 days. Alternatively, you can provide another financial account or [verified external account](https://docs.stripe.com/treasury/examples/moving-money.md#verifying-an-external-bank-account) to [forward](https://docs.stripe.com/treasury/account-management/financial-accounts.md#handling-transactions-on-closed-accounts) incoming debits and credits to.

> You can’t reopen financial accounts after you’ve closed them.

Closing a financial account has no impact on data retention for associated objects, such as `Transactions`.

## FinancialAccount closure using the API

You can use `POST/v1/treasury/financial_accounts/{{FINANCIAL_ACCOUNT_ID}}/close` to close the financial account with the associated ID. Include the associated connected account ID as a header value.

```bash
curl https://api.stripe.com/v1/treasury/financial_accounts/{{FINANCIAL_ACCOUNT_ID}}/close \
  -u <<YOUR_SECRET_KEY>>: \
  -X "POST" \
  -H "Stripe-Account: {{CONNECTED_STRIPE_ACCOUNT_ID}}"
```

The response is the `FinancialAccount` object with a `status` of `closed` to confirm the action.

```json
{
  "id": "{{FINANCIAL_ACCOUNT_ID}}",
  "object": "treasury.financial_account",
  "status": "closed",
  "status_details": {
    "closed": {
      "reasons": ["closed_by_platform"]
    }
  },
  "active_features": [],
  "pending_features": [],
  "restricted_features": ["financial_addresses.aba"],
  ...
}
```

### Handling transactions on closed accounts

In rare circumstances, financial accounts might receive credits or debits on closed accounts that Stripe can’t return automatically. As a platform owner, you’re responsible for negative balances incurred after account closure. Stripe support works with you to return any remaining funds owed to the seller or service provider and to remediate closed accounts with a negative balance. By including forwarding settings when closing a financial account, Stripe can automatically forward debits and credits to the selected account.

## Webhooks

You can create financial accounts before fulfilling onboarding requirements. In this case, the financial account opens asynchronously and then triggers a `treasury.financial_account.features_status_updated` [webhook](https://docs.stripe.com/webhooks.md) with an updated view on any features still restricted due to outstanding onboarding requirements.

- `account.updated`
  - When requesting new Features, the platform might get an `account.updated` webhook prompting that the requirements hash has changed and some new fields are now in `pending_verification`.
- `treasury.financial_account.created`
  - Triggered whenever a new FinancialAccount is created.
- `treasury.financial_account.closed`
  - Notifies when the status of the top-level FinancialAccount changes to closed.
- `treasury.financial_account.features_status_updated`
  - Indicates that one or more Features have changed status. This is reflected in changes to the `active_features, pending_features` or `restricted_features` arrays.