Core Resources
Payment Methods
Products
Checkout
Payment Links
Billing
Capital
Connect
Reserves
Fraud
Issuing
Terminal
Treasury
Entitlements
Sigma
Reporting
Financial Connections
Tax
Identity
Crypto
Climate
Forwarding
Privacy
Webhooks

Update a FinancialAccount 

Treasury
Financial Accounts
Update a FinancialAccount

Updates the details of a FinancialAccount.

Parameters

  • featuresobject

    Encodes whether a FinancialAccount has access to a particular feature, with a status enum and associated status_details. Stripe or the platform may control features via the requested field.

    • features.card_issuingobject

      Encodes the FinancialAccount’s ability to be used with the Issuing product, including attaching cards to and drawing funds from the FinancialAccount.

      • features.card_issuing.requestedbooleanRequired

        Whether the FinancialAccount should have the Feature.

    • features.deposit_insuranceobject

      Represents whether this FinancialAccount is eligible for deposit insurance. Various factors determine the insurance amount.

      • features.deposit_insurance.requestedbooleanRequired

        Whether the FinancialAccount should have the Feature.

    • features.financial_addressesobject

      Contains Features that add FinancialAddresses to the FinancialAccount.

      • features.financial_addresses.abaobject

        Adds an ABA FinancialAddress to the FinancialAccount.

        • features.financial_addresses.aba.requestedbooleanRequired

          Whether the FinancialAccount should have the Feature.

    • features.inbound_transfersobject

      Contains settings related to adding funds to a FinancialAccount from another Account with the same owner.

      • features.inbound_transfers.achobject

        Enables ACH Debits via the InboundTransfers API.

        • features.inbound_transfers.ach.requestedbooleanRequired

          Whether the FinancialAccount should have the Feature.

    • features.intra_stripe_flowsobject

      Represents the ability for the FinancialAccount to send money to, or receive money from other FinancialAccounts (for example, via OutboundPayment).

      • features.intra_stripe_flows.requestedbooleanRequired

        Whether the FinancialAccount should have the Feature.

    • features.outbound_paymentsobject

      Includes Features related to initiating money movement out of the FinancialAccount to someone else’s bucket of money.

      • features.outbound_payments.achobject

        Enables ACH transfers via the OutboundPayments API.

        • features.outbound_payments.ach.requestedbooleanRequired

          Whether the FinancialAccount should have the Feature.

      • features.outbound_payments.us_domestic_wireobject

        Enables US domestic wire transfers via the OutboundPayments API.

        • features.outbound_payments.us_domestic_wire.requestedbooleanRequired

          Whether the FinancialAccount should have the Feature.

    • features.outbound_transfersobject

      Contains a Feature and settings related to moving money out of the FinancialAccount into another Account with the same owner.

      • features.outbound_transfers.achobject

        Enables ACH transfers via the OutboundTransfers API.

        • features.outbound_transfers.ach.requestedbooleanRequired

          Whether the FinancialAccount should have the Feature.

      • features.outbound_transfers.us_domestic_wireobject

        Enables US domestic wire transfers via the OutboundTransfers API.

        • features.outbound_transfers.us_domestic_wire.requestedbooleanRequired

          Whether the FinancialAccount should have the Feature.

  • forwarding_settingsobject

    A different bank account where funds can be deposited/debited in order to get the closing FA’s balance to $0

    • forwarding_settings.typeenumRequired

      The type of the bank account provided. This can be either “financial_account” or “payment_method”

      Possible enum values
      financial_account

      A Financial Account belonging to the same Connected Account as the FA being closed

      payment_method

      A payment method or verified bank account id representing an external bank account

    • forwarding_settings.financial_accountstring

      The financial_account id

    • forwarding_settings.payment_methodstring

      The payment_method or bank account id. This needs to be a verified bank account.

  • metadataobject

    Set of key-value pairs that you can attach to an object. This can be useful for storing additional information about the object in a structured format. Individual keys can be unset by posting an empty value to them. All keys can be unset by posting an empty value to metadata.

  • nicknamestring

    The nickname for the FinancialAccount.

  • platform_restrictionsobject

    The set of functionalities that the platform can restrict on the FinancialAccount.

    • platform_restrictions.inbound_flowsenum

      Restricts all inbound money movement.

      Possible enum values
      restricted

      The functionality is restricted.

      unrestricted

      The functionality is not restricted.

    • platform_restrictions.outbound_flowsenum

      Restricts all outbound money movement.

      Possible enum values
      restricted

      The functionality is restricted.

      unrestricted

      The functionality is not restricted.

Returns

Returns a FinancialAccount object.

POST /v1/treasury/financial_accounts/:id
curl https://api.stripe.com/v1/treasury/financial_accounts/fa_1MtZmL2eZvKYlo2Cer6cdwEC \
  -u "sk_test_BQokikJ...2HlWgH4olfQ2sk_test_BQokikJOvBiI2HlWgH4olfQ2:" \
  -d "metadata[order_id]"=6735
Response
{
  "id": "fa_1MtZmL2eZvKYlo2Cer6cdwEC",
  "object": "treasury.financial_account",
  "active_features": [
    "financial_addresses.aba",
    "outbound_payments.ach",
    "outbound_payments.us_domestic_wire"
  ],
  "balance": {
    "cash": {
      "usd": 0
    },
    "inbound_pending": {
      "usd": 0
    },
    "outbound_pending": {
      "usd": 0
    }
  },
  "country": "US",
  "created": 1680714349,
  "financial_addresses": [
    {
      "aba": {
        "account_holder_name": "Jenny Rosen",
        "account_number_last4": "7890",
        "bank_name": "STRIPE TEST BANK",
        "routing_number": "0000000001"
      },
      "supported_networks": [
        "ach",
        "us_domestic_wire"
      ],
      "type": "aba"
    }
  ],
  "livemode": true,
  "metadata": {
    "order_id": "6735"
  },
  "pending_features": [],
  "restricted_features": [],
  "status": "open",
  "status_details": {
    "closed": null
  },
  "supported_currencies": [
    "usd"
  ],
  "features": {}
}