---
title: "Update FinancialAccount Features"
method: POST
path: "/v1/treasury/financial_accounts/{financial_account}/features"
---

# Update FinancialAccount Features

`POST /v1/treasury/financial_accounts/{financial_account}/features`

## Request

- Base URL: `https://api.stripe.com`
- URL: `https://api.stripe.com/v1/treasury/financial_accounts/{financial_account}/features`
- Auth: one of:
  - HTTP basic
  - HTTP bearer

Updates the Features associated with a FinancialAccount.

## Path parameters

- `financial_account` string, required

## Request body `application/x-www-form-urlencoded`

- object
  - `card_issuing` object: Encodes the FinancialAccount's ability to be used with the Issuing product, including attaching cards to and drawing funds from the FinancialAccount.
    - `requested` boolean, required
  - `deposit_insurance` object: Represents whether this FinancialAccount is eligible for deposit insurance. Various factors determine the insurance amount.
    - `requested` boolean, required
  - `expand` string[]: Specifies which fields in the response should be expanded.
  - `financial_addresses` object: Contains Features that add FinancialAddresses to the FinancialAccount.
    - `aba` object
      - `requested` boolean, required
  - `inbound_transfers` object: Contains settings related to adding funds to a FinancialAccount from another Account with the same owner.
    - `ach` object
      - `requested` boolean, required
  - `intra_stripe_flows` object: Represents the ability for the FinancialAccount to send money to, or receive money from other FinancialAccounts (for example, via OutboundPayment).
    - `requested` boolean, required
  - `outbound_payments` object: Includes Features related to initiating money movement out of the FinancialAccount to someone else's bucket of money.
    - `ach` object
      - `requested` boolean, required
    - `us_domestic_wire` object
      - `requested` boolean, required
  - `outbound_transfers` object: Contains a Feature and settings related to moving money out of the FinancialAccount into another Account with the same owner.
    - `ach` object
      - `requested` boolean, required
    - `us_domestic_wire` object
      - `requested` boolean, required

## Response `200`

Successful response.

- TreasuryFinancialAccountFeatures: Encodes whether a FinancialAccount has access to a particular Feature, with a `status` enum and associated `status_details`. Stripe or the platform can control Features via the requested field.
  - `card_issuing` TreasuryFinancialAccountsResourceToggleSettings: Toggle settings for enabling/disabling a feature
    - `requested` boolean, required: Whether the FinancialAccount should have the Feature.
    - `status` 'active' | 'pending' | 'restricted', required: Whether the Feature is operational.
    - `status_details` TreasuryFinancialAccountsResourceTogglesSettingStatusDetails[], required: Additional details; includes at least one entry when the status is not `active`.
      - `code` 'activating' | 'capability_not_requested' | 'financial_account_closed' | 'rejected_other' | 'rejected_unsupported_business' | 'requirements_past_due' | 'requirements_pending_verification' | 'restricted_by_platform' | 'restricted_other', required: Represents the reason why the status is `pending` or `restricted`.
      - `resolution` 'contact_stripe' | 'provide_information' | 'remove_restriction', nullable: Represents what the user should do, if anything, to activate the Feature.
      - `restriction` 'inbound_flows' | 'outbound_flows': The `platform_restrictions` that are restricting this Feature.
  - `deposit_insurance` TreasuryFinancialAccountsResourceToggleSettings: Toggle settings for enabling/disabling a feature
    - `requested` boolean, required: Whether the FinancialAccount should have the Feature.
    - `status` 'active' | 'pending' | 'restricted', required: Whether the Feature is operational.
    - `status_details` TreasuryFinancialAccountsResourceTogglesSettingStatusDetails[], required: Additional details; includes at least one entry when the status is not `active`.
      - `code` 'activating' | 'capability_not_requested' | 'financial_account_closed' | 'rejected_other' | 'rejected_unsupported_business' | 'requirements_past_due' | 'requirements_pending_verification' | 'restricted_by_platform' | 'restricted_other', required: Represents the reason why the status is `pending` or `restricted`.
      - `resolution` 'contact_stripe' | 'provide_information' | 'remove_restriction', nullable: Represents what the user should do, if anything, to activate the Feature.
      - `restriction` 'inbound_flows' | 'outbound_flows': The `platform_restrictions` that are restricting this Feature.
  - `financial_addresses` TreasuryFinancialAccountsResourceFinancialAddressesFeatures: Settings related to Financial Addresses features on a Financial Account
    - `aba` TreasuryFinancialAccountsResourceAbaToggleSettings: Toggle settings for enabling/disabling the ABA address feature
      - `requested` boolean, required: Whether the FinancialAccount should have the Feature.
      - `status` 'active' | 'pending' | 'restricted', required: Whether the Feature is operational.
      - `status_details` TreasuryFinancialAccountsResourceTogglesSettingStatusDetails[], required: Additional details; includes at least one entry when the status is not `active`.
        - `code` 'activating' | 'capability_not_requested' | 'financial_account_closed' | 'rejected_other' | 'rejected_unsupported_business' | 'requirements_past_due' | 'requirements_pending_verification' | 'restricted_by_platform' | 'restricted_other', required: Represents the reason why the status is `pending` or `restricted`.
        - `resolution` 'contact_stripe' | 'provide_information' | 'remove_restriction', nullable: Represents what the user should do, if anything, to activate the Feature.
        - `restriction` 'inbound_flows' | 'outbound_flows': The `platform_restrictions` that are restricting this Feature.
  - `inbound_transfers` TreasuryFinancialAccountsResourceInboundTransfers: InboundTransfers contains inbound transfers features for a FinancialAccount.
    - `ach` TreasuryFinancialAccountsResourceInboundAchToggleSettings: Toggle settings for enabling/disabling an inbound ACH specific feature
      - `requested` boolean, required: Whether the FinancialAccount should have the Feature.
      - `status` 'active' | 'pending' | 'restricted', required: Whether the Feature is operational.
      - `status_details` TreasuryFinancialAccountsResourceTogglesSettingStatusDetails[], required: Additional details; includes at least one entry when the status is not `active`.
        - `code` 'activating' | 'capability_not_requested' | 'financial_account_closed' | 'rejected_other' | 'rejected_unsupported_business' | 'requirements_past_due' | 'requirements_pending_verification' | 'restricted_by_platform' | 'restricted_other', required: Represents the reason why the status is `pending` or `restricted`.
        - `resolution` 'contact_stripe' | 'provide_information' | 'remove_restriction', nullable: Represents what the user should do, if anything, to activate the Feature.
        - `restriction` 'inbound_flows' | 'outbound_flows': The `platform_restrictions` that are restricting this Feature.
  - `intra_stripe_flows` TreasuryFinancialAccountsResourceToggleSettings: Toggle settings for enabling/disabling a feature
    - `requested` boolean, required: Whether the FinancialAccount should have the Feature.
    - `status` 'active' | 'pending' | 'restricted', required: Whether the Feature is operational.
    - `status_details` TreasuryFinancialAccountsResourceTogglesSettingStatusDetails[], required: Additional details; includes at least one entry when the status is not `active`.
      - `code` 'activating' | 'capability_not_requested' | 'financial_account_closed' | 'rejected_other' | 'rejected_unsupported_business' | 'requirements_past_due' | 'requirements_pending_verification' | 'restricted_by_platform' | 'restricted_other', required: Represents the reason why the status is `pending` or `restricted`.
      - `resolution` 'contact_stripe' | 'provide_information' | 'remove_restriction', nullable: Represents what the user should do, if anything, to activate the Feature.
      - `restriction` 'inbound_flows' | 'outbound_flows': The `platform_restrictions` that are restricting this Feature.
  - `object` 'treasury.financial_account_features', required: String representing the object's type. Objects of the same type share the same value.
  - `outbound_payments` TreasuryFinancialAccountsResourceOutboundPayments: Settings related to Outbound Payments features on a Financial Account
    - `ach` TreasuryFinancialAccountsResourceOutboundAchToggleSettings: Toggle settings for enabling/disabling an outbound ACH specific feature
      - `requested` boolean, required: Whether the FinancialAccount should have the Feature.
      - `status` 'active' | 'pending' | 'restricted', required: Whether the Feature is operational.
      - `status_details` TreasuryFinancialAccountsResourceTogglesSettingStatusDetails[], required: Additional details; includes at least one entry when the status is not `active`.
        - `code` 'activating' | 'capability_not_requested' | 'financial_account_closed' | 'rejected_other' | 'rejected_unsupported_business' | 'requirements_past_due' | 'requirements_pending_verification' | 'restricted_by_platform' | 'restricted_other', required: Represents the reason why the status is `pending` or `restricted`.
        - `resolution` 'contact_stripe' | 'provide_information' | 'remove_restriction', nullable: Represents what the user should do, if anything, to activate the Feature.
        - `restriction` 'inbound_flows' | 'outbound_flows': The `platform_restrictions` that are restricting this Feature.
    - `us_domestic_wire` TreasuryFinancialAccountsResourceToggleSettings: Toggle settings for enabling/disabling a feature
      - `requested` boolean, required: Whether the FinancialAccount should have the Feature.
      - `status` 'active' | 'pending' | 'restricted', required: Whether the Feature is operational.
      - `status_details` TreasuryFinancialAccountsResourceTogglesSettingStatusDetails[], required: Additional details; includes at least one entry when the status is not `active`.
        - `code` 'activating' | 'capability_not_requested' | 'financial_account_closed' | 'rejected_other' | 'rejected_unsupported_business' | 'requirements_past_due' | 'requirements_pending_verification' | 'restricted_by_platform' | 'restricted_other', required: Represents the reason why the status is `pending` or `restricted`.
        - `resolution` 'contact_stripe' | 'provide_information' | 'remove_restriction', nullable: Represents what the user should do, if anything, to activate the Feature.
        - `restriction` 'inbound_flows' | 'outbound_flows': The `platform_restrictions` that are restricting this Feature.
  - `outbound_transfers` TreasuryFinancialAccountsResourceOutboundTransfers: OutboundTransfers contains outbound transfers features for a FinancialAccount.
    - `ach` TreasuryFinancialAccountsResourceOutboundAchToggleSettings: Toggle settings for enabling/disabling an outbound ACH specific feature
      - `requested` boolean, required: Whether the FinancialAccount should have the Feature.
      - `status` 'active' | 'pending' | 'restricted', required: Whether the Feature is operational.
      - `status_details` TreasuryFinancialAccountsResourceTogglesSettingStatusDetails[], required: Additional details; includes at least one entry when the status is not `active`.
        - `code` 'activating' | 'capability_not_requested' | 'financial_account_closed' | 'rejected_other' | 'rejected_unsupported_business' | 'requirements_past_due' | 'requirements_pending_verification' | 'restricted_by_platform' | 'restricted_other', required: Represents the reason why the status is `pending` or `restricted`.
        - `resolution` 'contact_stripe' | 'provide_information' | 'remove_restriction', nullable: Represents what the user should do, if anything, to activate the Feature.
        - `restriction` 'inbound_flows' | 'outbound_flows': The `platform_restrictions` that are restricting this Feature.
    - `us_domestic_wire` TreasuryFinancialAccountsResourceToggleSettings: Toggle settings for enabling/disabling a feature
      - `requested` boolean, required: Whether the FinancialAccount should have the Feature.
      - `status` 'active' | 'pending' | 'restricted', required: Whether the Feature is operational.
      - `status_details` TreasuryFinancialAccountsResourceTogglesSettingStatusDetails[], required: Additional details; includes at least one entry when the status is not `active`.
        - `code` 'activating' | 'capability_not_requested' | 'financial_account_closed' | 'rejected_other' | 'rejected_unsupported_business' | 'requirements_past_due' | 'requirements_pending_verification' | 'restricted_by_platform' | 'restricted_other', required: Represents the reason why the status is `pending` or `restricted`.
        - `resolution` 'contact_stripe' | 'provide_information' | 'remove_restriction', nullable: Represents what the user should do, if anything, to activate the Feature.
        - `restriction` 'inbound_flows' | 'outbound_flows': The `platform_restrictions` that are restricting this Feature.

## Other responses

- `default`: Error response.

## Changes

> 56 revisions in range; 10 not diffed, 14 could not be searched.

- **2025-11-05** `c113b1939b8f`: 1 info
  - added the optional property `error/payment_intent/payment_method_options/anyOf[subschema #1: PaymentIntentPaymentMethodOptions]/card_present/anyOf[subschema #1: payment_method_options_card_present]/capture_method` to the response with the `default` status
- **2025-10-22** `7b8f614372ca`: 1 info
  - added the optional property `error/payment_intent/amount_details/anyOf[subschema #1: PaymentFlowsAmountDetails]/line_items/data/items/payment_method_options/anyOf[subschema #1: PaymentFlowsAmountDetailsResourceLineItemsListResourceLineItemResourcePaymentMethodOptions]/klarna/subscription_reference` to the response with the `default` status
- **2025-08-19** `cd1ebd88f70f`: 2 info
  - added the optional property `error/payment_intent/latest_charge/anyOf[subschema #2: Charge]/payment_method_details/anyOf[subschema #1: payment_method_details]/paynow/location` to the response with the `default` status
  - added the optional property `error/payment_intent/latest_charge/anyOf[subschema #2: Charge]/payment_method_details/anyOf[subschema #1: payment_method_details]/paynow/reader` to the response with the `default` status
- …earlier changes not shown

[Operation history](https://skmtc.dev/stripe/apis/spec3/changes/v1/treasury/financial_accounts/:financial_account/features/post.md)

---

[API](https://skmtc.dev/stripe/apis/spec3.md) - [All operations](https://skmtc.dev/stripe/apis/spec3/llms.txt) - [OpenAPI document](https://skmtc.dev/stripe/apis/spec3/revisions/585b581504ae?raw)
