# Updates Financial Address request and response structure

## What’s new

Replaces the country-specific [type](https://docs.stripe.com/api/v2/money-management/financial-addresses/create.md?api-version=2026-09-30.preview#v2_create_financial_addresses-type) values `gb_bank_account` and `us_bank_account` with a single `bank_account` value when creating a [v2 Financial Address](https://docs.stripe.com/api/v2/money-management/financial-addresses/create.md?api-version=2026-09-30.preview). A new [bank_account.currency](https://docs.stripe.com/api/v2/money-management/financial-addresses/create.md?api-version=2026-09-30.preview#v2_create_financial_addresses-bank_account-currency) parameter specifies the currency of the bank account to provision.

Previously, you indicated both the country and currency by passing a country-specific `type` such as `us_bank_account` or `gb_bank_account`. Now, pass `bank_account` as the `type` and include a `bank_account` hash with `currency` set to the desired currency (for example, `usd` or `gbp`).

## Why is this a breaking change?

The `gb_bank_account` and `us_bank_account` values for the `type` parameter on Financial Address creation are removed. Requests that pass either of these values return an error. Update your integration to pass `bank_account` as the `type` and include a `bank_account` hash with `currency`:

```

"type": "bank_account",
"bank_account": {
  "currency": "usd"
}
```

## Impact

The unified `bank_account` value for `type` simplifies Financial Address creation by removing the need to use a different `type` value for each country. As we add support for additional countries, you can use the same `type` value and specify the appropriate `bank_account.currency` without changing your integration logic.

If you currently create financial addresses with `type` set to `us_bank_account` or `gb_bank_account`, update those calls to use `bank_account` and add a `bank_account` hash with the corresponding `currency` value before upgrading to this API version.

## Changes

#### REST API

| Values | Change | Enums |
| --- | --- | --- |
| `bank_account` | Added | [V2.MoneyManagement.FinancialAddress#create.type](/api/v2/money-management/financial-addresses/create?api-version=2026-09-30.preview#v2_create_financial_addresses) |
| `gb_bank_account`, `us_bank_account` | Removed | [V2.MoneyManagement.FinancialAddress#create.type](/api/v2/money-management/financial-addresses/create?api-version=2026-09-30.preview#v2_create_financial_addresses) |

#### Ruby

| Parameters | Change | Resources or methods |
| --- | --- | --- |
| `bank_account`, `type` | Added | [V2::MoneyManagement::FinancialAddress](/api/v2/money-management/financial-addresses/object?api-version=2026-09-30.preview#v2_financial_address_object) |
| `bank_account`, `currency` | Added | [V2::MoneyManagement::FinancialAddressCreateParams](/api/v2/money-management/financial-addresses/create?api-version=2026-09-30.preview#v2_create_financial_addresses) |

#### Python

| Parameters | Change | Resources or methods |
| --- | --- | --- |
| `bank_account`, `type` | Added | [V2.MoneyManagement.FinancialAddress](/api/v2/money-management/financial-addresses/object?api-version=2026-09-30.preview#v2_financial_address_object) |
| `bank_account`, `currency` | Added | [v2.money_management.FinancialAddressCreateParams](/api/v2/money-management/financial-addresses/create?api-version=2026-09-30.preview#v2_create_financial_addresses) |

| Values | Change | Enums |
| --- | --- | --- |
| `bank_account` | Added | [v2.money_management.FinancialAddressCreateParams.type](/api/v2/money-management/financial-addresses/create?api-version=2026-09-30.preview#v2_create_financial_addresses) |
| `gb_bank_account`, `us_bank_account` | Removed | [v2.money_management.FinancialAddressCreateParams.type](/api/v2/money-management/financial-addresses/create?api-version=2026-09-30.preview#v2_create_financial_addresses) |

#### PHP

This change doesn’t affect the PHP SDK.

#### Java

| Parameters | Change | Resources or methods |
| --- | --- | --- |
| `bankAccount`, `currency` | Added | [v2.moneymanagement.FinancialAddressCreateParams](/api/v2/money-management/financial-addresses/create?api-version=2026-09-30.preview#v2_create_financial_addresses) |

| Values | Change | Enums |
| --- | --- | --- |
| `bank_account` | Added | [v2.moneymanagement.FinancialAddressCreateParams.type](/api/v2/money-management/financial-addresses/create?api-version=2026-09-30.preview#v2_create_financial_addresses) |
| `gb_bank_account`, `us_bank_account` | Removed | [v2.moneymanagement.FinancialAddressCreateParams.type](/api/v2/money-management/financial-addresses/create?api-version=2026-09-30.preview#v2_create_financial_addresses) |

#### Node.js

| Parameters | Change | Resources or methods |
| --- | --- | --- |
| `bank_account`, `type` | Added | [V2.MoneyManagement.FinancialAddress](/api/v2/money-management/financial-addresses/object?api-version=2026-09-30.preview#v2_financial_address_object) |
| `bank_account`, `currency` | Added | [V2.MoneyManagement.FinancialAddressCreateParams](/api/v2/money-management/financial-addresses/create?api-version=2026-09-30.preview#v2_create_financial_addresses) |

| Values | Change | Enums |
| --- | --- | --- |
| `bank_account` | Added | [V2.MoneyManagement.FinancialAddressCreateParams.type](/api/v2/money-management/financial-addresses/create?api-version=2026-09-30.preview#v2_create_financial_addresses) |
| `gb_bank_account`, `us_bank_account` | Removed | [V2.MoneyManagement.FinancialAddressCreateParams.type](/api/v2/money-management/financial-addresses/create?api-version=2026-09-30.preview#v2_create_financial_addresses) |

#### Go

| Parameters | Change | Resources or methods |
| --- | --- | --- |
| `BankAccount`, `Type` | Added | [V2MoneyManagementFinancialAddress](/api/v2/money-management/financial-addresses/object?api-version=2026-09-30.preview#v2_financial_address_object) |

#### .NET

| Parameters | Change | Resources or methods |
| --- | --- | --- |
| `BankAccount`, `Type` | Added | [V2.MoneyManagement.FinancialAddress](/api/v2/money-management/financial-addresses/object?api-version=2026-09-30.preview#v2_financial_address_object) |
| `BankAccount`, `Currency` | Added | [V2.MoneyManagement.FinancialAddressCreateOptions](/api/v2/money-management/financial-addresses/create?api-version=2026-09-30.preview#v2_create_financial_addresses) |

## Upgrade

#### REST API

1. [View your current API version](https://docs.stripe.com/workbench/guides.md#view-api-versions) in Workbench.
2. If you use an SDK, upgrade to the corresponding SDK version for this API version.
   - If you don’t use an SDK, update your [API requests](https://docs.stripe.com/api-versions.md#how-versions-are-specified-in-requests) to include `Stripe-Version: 2026-09-30.preview`
3. Upgrade the API version used for [webhook endpoints](https://docs.stripe.com/webhooks/versioning.md).
4. [Test your integration](https://docs.stripe.com/testing.md) against the new version.
5. If you use Connect, [test your Connect integration](https://docs.stripe.com/connect/testing.md).

Learn more about [Stripe API upgrades](https://docs.stripe.com/upgrades.md).

#### Ruby

1. [View your current API version](https://docs.stripe.com/upgrades.md#view-your-api-version-and-the-latest-available-upgrade-in-workbench) in Workbench.
2. Upgrade your Ruby SDK to the latest version.
3. Upgrade the API version used for [webhook endpoints](https://docs.stripe.com/webhooks/versioning.md).
4. [Test your integration](https://docs.stripe.com/testing.md) against the new version.
5. If you use Connect, [test your Connect integration](https://docs.stripe.com/connect/testing.md).
6. In Workbench, [perform the upgrade](https://docs.stripe.com/upgrades.md#perform-the-upgrade). You can [roll back the version](https://docs.stripe.com/upgrades.md#roll-back-your-api-version) for 72 hours.

Learn more about [Stripe API upgrades](https://docs.stripe.com/upgrades.md).

#### Python

1. [View your current API version](https://docs.stripe.com/upgrades.md#view-your-api-version-and-the-latest-available-upgrade-in-workbench) in Workbench.
2. Upgrade your Python SDK to the latest version.
3. Upgrade the API version used for [webhook endpoints](https://docs.stripe.com/webhooks/versioning.md).
4. [Test your integration](https://docs.stripe.com/testing.md) against the new version.
5. If you use Connect, [test your Connect integration](https://docs.stripe.com/connect/testing.md).
6. In Workbench, [perform the upgrade](https://docs.stripe.com/upgrades.md#perform-the-upgrade). You can [roll back the version](https://docs.stripe.com/upgrades.md#roll-back-your-api-version) for 72 hours.

Learn more about [Stripe API upgrades](https://docs.stripe.com/upgrades.md).

#### PHP

1. [View your current API version](https://docs.stripe.com/upgrades.md#view-your-api-version-and-the-latest-available-upgrade-in-workbench) in Workbench.
2. Upgrade your PHP SDK to the latest version.
3. Upgrade the API version used for [webhook endpoints](https://docs.stripe.com/webhooks/versioning.md).
4. [Test your integration](https://docs.stripe.com/testing.md) against the new version.
5. If you use Connect, [test your Connect integration](https://docs.stripe.com/connect/testing.md).
6. In Workbench, [perform the upgrade](https://docs.stripe.com/upgrades.md#perform-the-upgrade). You can [roll back the version](https://docs.stripe.com/upgrades.md#roll-back-your-api-version) for 72 hours.

Learn more about [Stripe API upgrades](https://docs.stripe.com/upgrades.md).

#### Java

1. [View your current API version](https://docs.stripe.com/upgrades.md#view-your-api-version-and-the-latest-available-upgrade-in-workbench) in Workbench.
2. Upgrade your Java SDK to the latest version.
3. Upgrade the API version used for [webhook endpoints](https://docs.stripe.com/webhooks/versioning.md).
4. [Test your integration](https://docs.stripe.com/testing.md) against the new version.
5. If you use Connect, [test your Connect integration](https://docs.stripe.com/connect/testing.md).
6. In Workbench, [perform the upgrade](https://docs.stripe.com/upgrades.md#perform-the-upgrade). You can [roll back the version](https://docs.stripe.com/upgrades.md#roll-back-your-api-version) for 72 hours.

Learn more about [Stripe API upgrades](https://docs.stripe.com/upgrades.md).

#### Node.js

1. [View your current API version](https://docs.stripe.com/upgrades.md#view-your-api-version-and-the-latest-available-upgrade-in-workbench) in Workbench.
2. Upgrade your Node SDK to the latest version.
3. Upgrade the API version used for [webhook endpoints](https://docs.stripe.com/webhooks/versioning.md).
4. [Test your integration](https://docs.stripe.com/testing.md) against the new version.
5. If you use Connect, [test your Connect integration](https://docs.stripe.com/connect/testing.md).
6. In Workbench, [perform the upgrade](https://docs.stripe.com/upgrades.md#perform-the-upgrade). You can [roll back the version](https://docs.stripe.com/upgrades.md#roll-back-your-api-version) for 72 hours.

Learn more about [Stripe API upgrades](https://docs.stripe.com/upgrades.md).

#### Go

1. [View your current API version](https://docs.stripe.com/upgrades.md#view-your-api-version-and-the-latest-available-upgrade-in-workbench) in Workbench.
2. Upgrade your Go SDK to the latest version.
3. Upgrade the API version used for [webhook endpoints](https://docs.stripe.com/webhooks/versioning.md).
4. [Test your integration](https://docs.stripe.com/testing.md) against the new version.
5. If you use Connect, [test your Connect integration](https://docs.stripe.com/connect/testing.md).
6. In Workbench, [perform the upgrade](https://docs.stripe.com/upgrades.md#perform-the-upgrade). You can [roll back the version](https://docs.stripe.com/upgrades.md#roll-back-your-api-version) for 72 hours.

Learn more about [Stripe API upgrades](https://docs.stripe.com/upgrades.md).

#### .NET

1. [View your current API version](https://docs.stripe.com/upgrades.md#view-your-api-version-and-the-latest-available-upgrade-in-workbench) in Workbench.
2. Upgrade your .NET SDK to the latest version.
3. Upgrade the API version used for [webhook endpoints](https://docs.stripe.com/webhooks/versioning.md).
4. [Test your integration](https://docs.stripe.com/testing.md) against the new version.
5. If you use Connect, [test your Connect integration](https://docs.stripe.com/connect/testing.md).
6. In Workbench, [perform the upgrade](https://docs.stripe.com/upgrades.md#perform-the-upgrade). You can [roll back the version](https://docs.stripe.com/upgrades.md#roll-back-your-api-version) for 72 hours.

Learn more about [Stripe API upgrades](https://docs.stripe.com/upgrades.md).

## Related changes

- [Updates the shapes of v2 Financial Address and v2 Received Credit objects](https://docs.stripe.com/changelog/endive/2026-09-30/financial-address-and-received-credit-shape-updates.md)
- [Removes level property from inbound transfer history and changes date filtering syntax for list endpoints](https://docs.stripe.com/changelog/endive/2026-09-30/removes-level-property-from-inbound-transfer-history-and-changes-date-filtering-syntax-for-list-endpoints.md)
- [Moves Financial Address test helper endpoints to the money management namespace](https://docs.stripe.com/changelog/endive/2026-09-30/moves-financial-address-test-helper-endpoints-to-the-money-management-namespace.md)
- [Opens the adjusted flow type enum and changes the list filters for v2 Adjustments and v2 Transactions](https://docs.stripe.com/changelog/endive/2026-09-30/opens-adjusted-flow-type-enum-and-changes-date-filtering-syntax.md)
- [Expands Reserve Plan listing access and adds filters](https://docs.stripe.com/changelog/endive/2026-09-30/expands-reserve-plan-listing-access.md)
- [Adds a Treasury Transaction property to the Money Management Transaction update events](https://docs.stripe.com/changelog/endive/2026-09-30/treasury-transaction-property-for-money-management-transaction-update-events.md)
- [Adds deposit insurance eligibility details to Financial Accounts](https://docs.stripe.com/changelog/endive/2026-09-30/includable-insurance-eligibility-field-for-v2-financial-accounts.md)
- [Adds network fee details to estimated fees on Outbound Payment Quotes](https://docs.stripe.com/changelog/endive/2026-09-30/adds-network-fee-details-to-estimated-fees.md)