# Update a Financial Account

Updates an existing FinancialAccount.

## Parameters

- `id` (string, required)
  ID of the FinancialAccount to get updated.

- `display_name` (string, optional)
  A descriptive name for the FinancialAccount, up to 50 characters long. This name will be used in the Stripe Dashboard and embedded components.

- `metadata` (map, optional)
  Metadata associated with the FinancialAccount.

## Returns

## Response attributes

- `id` (string)
  Unique identifier for the object.

- `object` (string, value is "v2.money_management.financial_account")
  String representing the object’s type. Objects of the same type share the same value of the object field.

- `balance` (object)
  Multi-currency balance of this FinancialAccount, split by availability state. Each balance is represented as a hash where the key is the three-letter ISO currency code, in lowercase, and the value is the amount for that currency.

  - `balance.available` (map)
    Balance that can be used for money movement.

  - `balance.inbound_pending` (map)
    Balance of inbound funds that will later transition to the `available` balance.

  - `balance.outbound_pending` (map)
    Balance of funds that are being used for a pending outbound money movement.

- `country` (enum)
  Two-letter country code that represents the country where the LegalEntity associated with the FinancialAccount is based in.

- `created` (timestamp)
  Time at which the object was created.

- `display_name` (string, nullable)
  A descriptive name for the FinancialAccount, up to 50 characters long. This name will be used in the Stripe Dashboard and embedded components.

- `livemode` (boolean)
  Has the value `true` if the object exists in live mode or the value `false` if the object exists in test mode.

- `metadata` (map, nullable)
  Metadata associated with the FinancialAccount.

- `other` (object, nullable)
  If this is a `other` FinancialAccount, this hash indicates what the actual type is. Upgrade your API version to see it reflected in `type`.

  - `other.type` (string)
    The type of the FinancialAccount, represented as a string. Upgrade your API version to see the type reflected in `financial_account.type`.

- `status` (enum)
  An enum representing the status of the FinancialAccount. This indicates whether or not the FinancialAccount can be used for any money movement flows.
Possible enum values:
  - `closed`
    The FinancialAccount is closed and cannot be used anymore.

  - `open`
    The FinancialAccount is open and available for use.

  - `pending`
    The FinancialAccount was created and is in the process of being opened.

- `status_details` (object, nullable)
  - `status_details.closed` (object, nullable)
    - `status_details.closed.forwarding_settings` (object, nullable)
      - `status_details.closed.forwarding_settings.payment_method` (string, nullable)
        The address to send forwarded payments to.

      - `status_details.closed.forwarding_settings.payout_method` (string, nullable)
        The address to send forwarded payouts to.
    - `status_details.closed.reason` (enum)Possible enum values:
      - `account_closed`
        The FinancialAccount is closed by stripe

      - `closed_by_platform`
        The FinancialAccount is closed by platform

- `storage` (object, nullable)
  If this is a `storage` FinancialAccount, this hash includes details specific to `storage` FinancialAccounts.

  - `storage.holds_currencies` (array of enums)
    The currencies that this FinancialAccount can hold.

- `type` (enum)
  Type of the FinancialAccount. An additional hash is included on the FinancialAccount with a name matching this value. It contains additional information specific to the FinancialAccount type.
Possible enum values:
  - `other`
    The API version used does not support the FinancialAccount’s type.

  - `storage`
    Used for the long term storage of funds and sending those funds to others.

## Error Codes

| HTTP status code | Code                                                        | Description                                                                                              |
| ---------------- | ----------------------------------------------------------- | -------------------------------------------------------------------------------------------------------- |
| 400              | platform_financial_account_currency_required                | The currency is not supported as the platform does not have a Financial Account that holds the currency. |
| 400              | unsupported_operation_on_managed_financial_account_resource | Modification of an object is not allowed on a managed account.                                           |
| 404              | not_found                                                   | The resource wasn’t found.                                                                               |

```curl
curl -X POST https://api.stripe.com/v2/money_management/financial_accounts/fa_65NvTFNdpXXUx1kx1rB16NoTesLDSQ1IgNPigisRKq09iq \
  -H "Authorization: Bearer <<YOUR_SECRET_KEY>>" \
  -H "Stripe-Version: 2026-01-28.preview" \
  --json '{
    "display_name": "My FinancialAccount",
    "metadata": {
        "key": "value"
    }
  }'
```

### Response

```json
{
  "id": "fa_65NvTFNdpXXUx1kx1rB16NoTesLDSQ1IgNPigisRKq09iq",
  "object": "v2.money_management.financial_account",
  "balance": {
    "available": {
      "usd": {
        "value": 0,
        "currency": "usd"
      }
    },
    "inbound_pending": {
      "usd": {
        "value": 0,
        "currency": "usd"
      }
    },
    "outbound_pending": {
      "usd": {
        "value": 0,
        "currency": "usd"
      }
    }
  },
  "country": "US",
  "created": "2025-06-27T21:52:05.197Z",
  "display_name": "My FinancialAccount",
  "livemode": true,
  "metadata": {
    "key": "value"
  },
  "status": "open",
  "storage": {
    "holds_currencies": [
      "usd"
    ]
  },
  "type": "storage"
}
```