Stripe: Update Financial Account Features

← Treasury operations · Get started

Operation stripe.posttreasuryfinancialaccountsfinancialaccountfeatures

Provider route: POST /v1/treasury/financial_accounts/{financial_account}/features. Alter supplies the connection’s credentials and routing.

Call through Alter

Install @alter-ai/sdk @alter-ai/stripe with npm, or alter-sdk-stripe with pip. Supply your connected customer’s grant ID and the arguments described below.

import { App } from "@alter-ai/sdk";
import { StripeIntegration } from "@alter-ai/stripe";

async function execute(input: Parameters<StripeIntegration["treasury"]["postTreasuryFinancialAccountsFinancialAccountFeatures"]>[0]) {
  const app = new App({ apiKey: process.env.ALTER_API_KEY! });
  try {
    const provider = new StripeIntegration(app, { grantId: process.env.PROVIDER_GRANT_ID! });
    const call = await provider.treasury.postTreasuryFinancialAccountsFinancialAccountFeatures(input);
    const result = await call.wait();
    return result.bodyJson();
  } finally {
    await app.close();
  }
}

import os
from alter_sdk import App
from alter_sdk_stripe import StripeIntegration

async def execute(arguments):
    async with App(api_key=os.environ["ALTER_API_KEY"]) as app:
        provider = StripeIntegration(app, {"grant_id": os.environ["PROVIDER_GRANT_ID"]})
        call = await provider.treasury.post_treasury_financial_accounts_financial_account_features(arguments)
        result = await call.wait()
        return result.body_json()

Input

Field	Type	Presence	Description and constraints
$	object	Root	Additional keys: not allowed
path	object	Required within parent	Additional keys: not allowed
path.financial_account	string	Required within parent	Maximum length: 5000
headers	object	Optional	Additional keys: not allowed
headers.Idempotency-Key	string	Optional	Minimum length: 1 Maximum length: 255
body	object	Optional	Additional keys: not allowed
body.card_issuing	object	Optional	Encodes the FinancialAccount’s ability to be used with the Issuing product, including attaching cards to and drawing funds from the FinancialAccount.
body.card_issuing.requested	boolean	Required within parent
body.deposit_insurance	object	Optional	Represents whether this FinancialAccount is eligible for deposit insurance. Various factors determine the insurance amount.
body.deposit_insurance.requested	boolean	Required within parent
body.expand	array	Optional	Specifies which fields in the response should be expanded.
body.expand[]	string	Each item	Maximum length: 5000
body.financial_addresses	object	Optional	Contains Features that add FinancialAddresses to the FinancialAccount.
body.financial_addresses.aba	object	Optional
body.financial_addresses.aba.requested	boolean	Required within parent
body.inbound_transfers	object	Optional	Contains settings related to adding funds to a FinancialAccount from another Account with the same owner.
body.inbound_transfers.ach	object	Optional
body.inbound_transfers.ach.requested	boolean	Required within parent
body.intra_stripe_flows	object	Optional	Represents the ability for the FinancialAccount to send money to, or receive money from other FinancialAccounts (for example, via OutboundPayment).
body.intra_stripe_flows.requested	boolean	Required within parent
body.outbound_payments	object	Optional	Includes Features related to initiating money movement out of the FinancialAccount to someone else’s bucket of money.
body.outbound_payments.ach	object	Optional
body.outbound_payments.ach.requested	boolean	Required within parent
body.outbound_payments.us_domestic_wire	object	Optional
body.outbound_payments.us_domestic_wire.requested	boolean	Required within parent
body.outbound_transfers	object	Optional	Contains a Feature and settings related to moving money out of the FinancialAccount into another Account with the same owner.
body.outbound_transfers.ach	object	Optional
body.outbound_transfers.ach.requested	boolean	Required within parent
body.outbound_transfers.us_domestic_wire	object	Optional
body.outbound_transfers.us_domestic_wire.requested	boolean	Required within parent

Response

Response media type: application/json. The table describes the pinned successful response. Referenced models link to their complete fields.

Field	Type	Presence	Description and constraints
$	Model	Root	Expand Update Financial Account Features — response body

Referenced models: Update Financial Account Features — response body

Schemas

Update Financial Account Features — response body

Field	Type	Presence	Description and constraints
$	object	Root	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	Model	Optional	Expand Update Financial Account Features — response body — card issuing
deposit_insurance	Model	Optional	Expand Update Financial Account Features — response body — card issuing
financial_addresses	Model	Optional	Expand Update Financial Account Features — response body — financial addresses
inbound_transfers	Model	Optional	Expand Update Financial Account Features — response body — inbound transfers
intra_stripe_flows	Model	Optional	Expand Update Financial Account Features — response body — card issuing
object	string	Required within parent	String representing the object's type. Objects of the same type share the same value. Known values: treasury.financial_account_features
outbound_payments	Model	Optional	Expand Update Financial Account Features — response body — outbound payments
outbound_transfers	Model	Optional	Expand Update Financial Account Features — response body — outbound transfers

Referenced models: Update Financial Account Features — response body — financial addresses, Update Financial Account Features — response body — inbound transfers, Update Financial Account Features — response body — outbound payments, Update Financial Account Features — response body — outbound transfers, Update Financial Account Features — response body — card issuing

Update Financial Account Features — response body — financial addresses

Field	Type	Presence	Description and constraints
$	object	Root	Settings related to Financial Addresses features on a Financial Account
aba	Model	Optional	Expand Update Financial Account Features — response body — financial addresses aba

Referenced models: Update Financial Account Features — response body — financial addresses aba

Update Financial Account Features — response body — inbound transfers

Field	Type	Presence	Description and constraints
$	object	Root	InboundTransfers contains inbound transfers features for a FinancialAccount.
ach	Model	Optional	Expand Update Financial Account Features — response body — inbound transfers ach

Referenced models: Update Financial Account Features — response body — inbound transfers ach

Update Financial Account Features — response body — outbound payments

Field	Type	Presence	Description and constraints
$	object	Root	Settings related to Outbound Payments features on a Financial Account
ach	Model	Optional	Expand Update Financial Account Features — response body — outbound payments ach
us_domestic_wire	Model	Optional	Expand Update Financial Account Features — response body — card issuing

Referenced models: Update Financial Account Features — response body — outbound payments ach, Update Financial Account Features — response body — card issuing

Update Financial Account Features — response body — outbound transfers

Field	Type	Presence	Description and constraints
$	object	Root	OutboundTransfers contains outbound transfers features for a FinancialAccount.
ach	Model	Optional	Expand Update Financial Account Features — response body — outbound payments ach
us_domestic_wire	Model	Optional	Expand Update Financial Account Features — response body — card issuing

Referenced models: Update Financial Account Features — response body — outbound payments ach, Update Financial Account Features — response body — card issuing

Update Financial Account Features — response body — card issuing

Field	Type	Presence	Description and constraints
$	object	Root	Toggle settings for enabling/disabling a feature
requested	boolean	Required within parent	Whether the FinancialAccount should have the Feature.
status	string	Required within parent	Whether the Feature is operational. Known values: active, pending, restricted
status_details	array	Required within parent	Additional details; includes at least one entry when the status is not `active`.
status_details[]	Model	Each item	Expand Update Financial Account Features — response body — card issuing status details item

Referenced models: Update Financial Account Features — response body — card issuing status details item

Update Financial Account Features — response body — financial addresses aba

Field	Type	Presence	Description and constraints
$	object	Root	Toggle settings for enabling/disabling the ABA address feature
requested	boolean	Required within parent	Whether the FinancialAccount should have the Feature.
status	string	Required within parent	Whether the Feature is operational. Known values: active, pending, restricted
status_details	array	Required within parent	Additional details; includes at least one entry when the status is not `active`.
status_details[]	Model	Each item	Expand Update Financial Account Features — response body — card issuing status details item

Referenced models: Update Financial Account Features — response body — card issuing status details item

Update Financial Account Features — response body — inbound transfers ach

Field	Type	Presence	Description and constraints
$	object	Root	Toggle settings for enabling/disabling an inbound ACH specific feature
requested	boolean	Required within parent	Whether the FinancialAccount should have the Feature.
status	string	Required within parent	Whether the Feature is operational. Known values: active, pending, restricted
status_details	array	Required within parent	Additional details; includes at least one entry when the status is not `active`.
status_details[]	Model	Each item	Expand Update Financial Account Features — response body — card issuing status details item

Referenced models: Update Financial Account Features — response body — card issuing status details item

Update Financial Account Features — response body — outbound payments ach

Field	Type	Presence	Description and constraints
$	object	Root	Toggle settings for enabling/disabling an outbound ACH specific feature
requested	boolean	Required within parent	Whether the FinancialAccount should have the Feature.
status	string	Required within parent	Whether the Feature is operational. Known values: active, pending, restricted
status_details	array	Required within parent	Additional details; includes at least one entry when the status is not `active`.
status_details[]	Model	Each item	Expand Update Financial Account Features — response body — card issuing status details item

Referenced models: Update Financial Account Features — response body — card issuing status details item

Update Financial Account Features — response body — card issuing status details item

Field	Type	Presence	Description and constraints
$	object	Root	Additional details on the FinancialAccount Features information.
code	string	Required within parent	Represents the reason why the status is `pending` or `restricted`. Known values: activating, capability_not_requested, financial_account_closed, rejected_other, rejected_unsupported_business, requirements_past_due, requirements_pending_verification, restricted_by_platform, restricted_other
resolution	JSON	Optional
resolution (anyOf 1)	string	Alternative	Represents what the user should do, if anything, to activate the Feature. Known values: contact_stripe, provide_information, remove_restriction
resolution (anyOf 2)	null	Alternative
restriction	string	Optional	The `platform_restrictions` that are restricting this Feature. Known values: inbound_flows, outbound_flows

Policy, approvals and errors

SDK function policy ID: stripe.posttreasuryfinancialaccountsfinancialaccountfeatures. Catalog operation: PostTreasuryFinancialAccountsFinancialAccountFeatures. Rules can name either ID; function rules distinguish managed calls and conservatively cover raw calls sharing the route. Existing grant permissions and policy rules apply. wait() returns an immediate result or waits for a required approval; it never approves the request itself. Persist the approval ID to resume after a restart.

Provider errors retain their response; JSON decoding raises ProviderAPIError for provider failures. ManagedOperationError identifies contract/input/retention errors. See error handling and provider-specific behavior. Sensitive input may be refused before approval storage. A decoding error never resubmits a write.

Pinned headers: {"Stripe-Version": "2026-09-30.endive"}

Official provider source