# Updates the shapes of v2 Financial Address and v2 Received Credit objects

## What’s new

Updates the [v2 Financial Addresses](https://docs.stripe.com/api/v2/money-management/financial-addresses/object.md?api-version=2026-09-30.preview) object:

- The [credentials](https://docs.stripe.com/api/v2/money-management/financial-addresses/object.md?api-version=2026-08-26.preview#v2_financial_address_object-credentials) hash is replaced with a [bank_account](https://docs.stripe.com/api/v2/money-management/financial-addresses/object.md?api-version=2026-09-30.preview#v2_financial_address_object-bank_account) hash that contains routing details, a [type](https://docs.stripe.com/api/v2/money-management/financial-addresses/object.md?api-version=2026-09-30.preview#v2_financial_address_object-bank_account-type) (such as `aba`, `iban`, or `sort_code`), and a [currency](https://docs.stripe.com/api/v2/money-management/financial-addresses/object.md?api-version=2026-09-30.preview#v2_financial_address_object-bank_account-currency).
- Previously, the [type](https://docs.stripe.com/api/v2/money-management/financial-addresses/create.md?api-version=2026-09-30.preview#v2_create_financial_addresses-type) parameter accepted `gb_bank_account` or `us_bank_account` for create requests. Now it accepts `bank_account`.
- The [include](https://docs.stripe.com/api/v2/money-management/financial-addresses/list.md?api-version=2026-08-26.preview#v2_list_financial_addresses-include) parameter is removed from the [list](https://docs.stripe.com/api/v2/money-management/financial-addresses/list.md?api-version=2026-09-30.preview) and [retrieve](https://docs.stripe.com/api/v2/money-management/financial-addresses/retrieve.md?api-version=2026-09-30.preview) methods.

Updates the [v2 Received Credits](https://docs.stripe.com/api/v2/money-management/received-credits/object.md?api-version=2026-09-30.preview) object:

- Adds the [amount_received](https://docs.stripe.com/api/v2/money-management/received-credits/object.md?api-version=2026-09-30.preview#v2_received_credit_object-amount_received) property.
- Adds the [originating_bank_account](https://docs.stripe.com/api/v2/money-management/received-credits/object.md?api-version=2026-09-30.preview#v2_received_credit_object-bank_transfer-originating_bank_account) property to the [bank_transfer](https://docs.stripe.com/api/v2/money-management/received-credits/object.md?api-version=2026-09-30.preview#v2_received_credit_object-bank_transfer) hash.
- The [origin_type](https://docs.stripe.com/api/v2/money-management/received-credits/object.md?api-version=2026-08-26.preview#v2_received_credit_object-bank_transfer-origin_type) property is removed from the [bank_transfer](https://docs.stripe.com/api/v2/money-management/received-credits/object.md?api-version=2026-09-30.preview#v2_received_credit_object-bank_transfer) hash.

## Why is this a breaking change?

These shape changes include multiple breaking changes:

- If your integration passes or reads the `credentials` hash on v2 Financial Addresses, you need to update your code to use `bank_account` instead. This hash contains a required `currency` parameter.
- If your integration passes the `type` parameter when creating v2 Financial Addresses, you need to update your code to set the value to `bank_account` instead of `gb_bank_account` or `us_bank_account`.
- You can no longer pass the `include` parameter when listing and retrieving v2 Financial Addresses.
- If your integration reads the `bank_transfer.origin_type` property on v2 Received Credits, you need to update your code to read `bank_transfer.originating_bank_account.type` instead.

## Changes

#### REST API

| Parameters | Change | Resources or endpoints |
| --- | --- | --- |
| `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.FinancialAddress#create](/api/v2/money-management/financial-addresses/create?api-version=2026-09-30.preview#v2_create_financial_addresses) |
| `credentials`, `currency` | Removed | [V2.MoneyManagement.FinancialAddress](/api/v2/money-management/financial-addresses/object?api-version=2026-09-30.preview#v2_financial_address_object) |
| `amount_received` | Added | [V2.MoneyManagement.ReceivedCredit](/api/v2/money-management/received-credits/object?api-version=2026-09-30.preview#v2_received_credit_object) |
| `originating_bank_account` | Added | [V2.MoneyManagement.ReceivedCredit.bank_transfer](/api/v2/money-management/received-credits/object?api-version=2026-09-30.preview#v2_received_credit_object-bank_transfer) |
| `origin_type` | Removed | [V2.MoneyManagement.ReceivedCredit.bank_transfer](/api/v2/money-management/received-credits/object?api-version=2026-09-30.preview#v2_received_credit_object-bank_transfer) |
| `include` | Removed | [V2.MoneyManagement.FinancialAddress#list](/api/v2/money-management/financial-addresses/list?api-version=2026-09-30.preview#v2_list_financial_addresses), [V2.MoneyManagement.FinancialAddress#retrieve](/api/v2/money-management/financial-addresses/retrieve?api-version=2026-09-30.preview#v2_retrieve_financial_addresses) |

| Field | Change | From → to |
| --- | --- | --- |
| `V2.MoneyManagement.FinancialAddress#create.type` | Changed | `enum('gb_bank_account'|'us_bank_account') → literal('bank_account')` |

| Code | Change |  |
| --- | --- | --- |
| `us_bank_account_cannot_be_archived` | Added | `controlled_by_alternate_resource` |
|  | Removed | `controlled_by_dashboard` |

#### 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) |
| `credentials`, `currency` | Removed | [V2::MoneyManagement::FinancialAddress](/api/v2/money-management/financial-addresses/object?api-version=2026-09-30.preview#v2_financial_address_object) |
| `amount_received` | Added | [V2::MoneyManagement::ReceivedCredit](/api/v2/money-management/received-credits/object?api-version=2026-09-30.preview#v2_received_credit_object) |
| `originating_bank_account` | Added | [V2::MoneyManagement::ReceivedCredit::BankTransfer](/api/v2/money-management/received-credits/object?api-version=2026-09-30.preview#v2_received_credit_object-bank_transfer) |
| `origin_type` | Removed | [V2::MoneyManagement::ReceivedCredit::BankTransfer](/api/v2/money-management/received-credits/object?api-version=2026-09-30.preview#v2_received_credit_object-bank_transfer) |
| `include` | Removed | [V2::MoneyManagement::FinancialAddressListParams](/api/v2/money-management/financial-addresses/list?api-version=2026-09-30.preview#v2_list_financial_addresses), [V2::MoneyManagement::FinancialAddressRetrieveParams](/api/v2/money-management/financial-addresses/retrieve?api-version=2026-09-30.preview#v2_retrieve_financial_addresses) |

| Field | Change | From → to |
| --- | --- | --- |
| `V2::MoneyManagement::FinancialAddressCreateParams.type` | Changed | `enum('gb_bank_account'|'us_bank_account') → literal('bank_account')` |

| Codes | Change |  |
| --- | --- | --- |
|  | Removed | `ControlledByDashboardError` |

#### 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) |
| `credentials`, `currency` | Removed | [V2.MoneyManagement.FinancialAddress](/api/v2/money-management/financial-addresses/object?api-version=2026-09-30.preview#v2_financial_address_object) |
| `amount_received` | Added | [V2.MoneyManagement.ReceivedCredit](/api/v2/money-management/received-credits/object?api-version=2026-09-30.preview#v2_received_credit_object) |
| `originating_bank_account` | Added | [V2.MoneyManagement.ReceivedCredit.BankTransfer](/api/v2/money-management/received-credits/object?api-version=2026-09-30.preview#v2_received_credit_object-bank_transfer) |
| `origin_type` | Removed | [V2.MoneyManagement.ReceivedCredit.BankTransfer](/api/v2/money-management/received-credits/object?api-version=2026-09-30.preview#v2_received_credit_object-bank_transfer) |
| `include` | Removed | [v2.money_management.FinancialAddressListParams](/api/v2/money-management/financial-addresses/list?api-version=2026-09-30.preview#v2_list_financial_addresses), [v2.money_management.FinancialAddressRetrieveParams](/api/v2/money-management/financial-addresses/retrieve?api-version=2026-09-30.preview#v2_retrieve_financial_addresses) |

| Field | Change | From → to |
| --- | --- | --- |
| `v2.money_management.FinancialAddressCreateParams.type` | Changed | `enum('gb_bank_account'|'us_bank_account') → literal('bank_account')` |

| Code | Change |  |
| --- | --- | --- |
| `us_bank_account_cannot_be_archived` | Added | `ControlledByAlternateResourceError` |
|  | Removed | `ControlledByDashboardError` |

#### PHP

| 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\FinancialAddress.create().$params](/api/v2/money-management/financial-addresses/create?api-version=2026-09-30.preview#v2_create_financial_addresses) |
| `credentials`, `currency` | Removed | [V2.MoneyManagement.FinancialAddress](/api/v2/money-management/financial-addresses/object?api-version=2026-09-30.preview#v2_financial_address_object) |
| `amount_received` | Added | [V2.MoneyManagement.ReceivedCredit](/api/v2/money-management/received-credits/object?api-version=2026-09-30.preview#v2_received_credit_object) |
| `originating_bank_account` | Added | [V2.MoneyManagement.ReceivedCredit.bank_transfer](/api/v2/money-management/received-credits/object?api-version=2026-09-30.preview#v2_received_credit_object-bank_transfer) |
| `origin_type` | Removed | [V2.MoneyManagement.ReceivedCredit.bank_transfer](/api/v2/money-management/received-credits/object?api-version=2026-09-30.preview#v2_received_credit_object-bank_transfer) |
| `include` | Removed | [V2\MoneyManagement\FinancialAddress.all().$params](/api/v2/money-management/financial-addresses/list?api-version=2026-09-30.preview#v2_list_financial_addresses), [V2\MoneyManagement\FinancialAddress.retrieve().$params](/api/v2/money-management/financial-addresses/retrieve?api-version=2026-09-30.preview#v2_retrieve_financial_addresses) |

| Field | Change | From → to |
| --- | --- | --- |
| `V2\MoneyManagement\FinancialAddress.create().$params.type` | Changed | `enum('gb_bank_account'|'us_bank_account') → literal('bank_account')` |

| Codes | Change |  |
| --- | --- | --- |
|  | Removed | `ControlledByDashboardException` |

#### Java

| 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`, `settlementCurrency` | Added | [v2.moneymanagement.FinancialAddressCreateParams](/api/v2/money-management/financial-addresses/create?api-version=2026-09-30.preview#v2_create_financial_addresses) |
| `credentials`, `currency` | Removed | [v2.moneymanagement.FinancialAddress](/api/v2/money-management/financial-addresses/object?api-version=2026-09-30.preview#v2_financial_address_object) |
| `amountReceived` | Added | [v2.moneymanagement.ReceivedCredit](/api/v2/money-management/received-credits/object?api-version=2026-09-30.preview#v2_received_credit_object) |
| `originatingBankAccount` | Added | [v2.moneymanagement.ReceivedCredit.bank_transfer](/api/v2/money-management/received-credits/object?api-version=2026-09-30.preview#v2_received_credit_object-bank_transfer) |
| `originType` | Removed | [v2.moneymanagement.ReceivedCredit.bank_transfer](/api/v2/money-management/received-credits/object?api-version=2026-09-30.preview#v2_received_credit_object-bank_transfer) |
| `include` | Removed | [v2.moneymanagement.FinancialAddressListParams](/api/v2/money-management/financial-addresses/list?api-version=2026-09-30.preview#v2_list_financial_addresses), [v2.moneymanagement.FinancialAddressRetrieveParams](/api/v2/money-management/financial-addresses/retrieve?api-version=2026-09-30.preview#v2_retrieve_financial_addresses) |

| Field | Change | From → to |
| --- | --- | --- |
| `v2.moneymanagement.FinancialAddressCreateParams.type` | Changed | `enum('gb_bank_account'|'us_bank_account') → literal('bank_account')` |

| Codes | Change |  |
| --- | --- | --- |
|  | Removed | `ControlledByDashboardException` |

#### 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) |
| `credentials`, `currency` | Removed | [V2.MoneyManagement.FinancialAddress](/api/v2/money-management/financial-addresses/object?api-version=2026-09-30.preview#v2_financial_address_object) |
| `amount_received` | Added | [V2.MoneyManagement.ReceivedCredit](/api/v2/money-management/received-credits/object?api-version=2026-09-30.preview#v2_received_credit_object) |
| `originating_bank_account` | Added | [V2.MoneyManagement.ReceivedCredit.bank_transfer](/api/v2/money-management/received-credits/object?api-version=2026-09-30.preview#v2_received_credit_object-bank_transfer) |
| `origin_type` | Removed | [V2.MoneyManagement.ReceivedCredit.bank_transfer](/api/v2/money-management/received-credits/object?api-version=2026-09-30.preview#v2_received_credit_object-bank_transfer) |
| `include` | Removed | [V2.MoneyManagement.FinancialAddressListParams](/api/v2/money-management/financial-addresses/list?api-version=2026-09-30.preview#v2_list_financial_addresses), [V2.MoneyManagement.FinancialAddressRetrieveParams](/api/v2/money-management/financial-addresses/retrieve?api-version=2026-09-30.preview#v2_retrieve_financial_addresses) |

| Field | Change | From → to |
| --- | --- | --- |
| `V2.MoneyManagement.FinancialAddressCreateParams.type` | Changed | `enum('gb_bank_account'|'us_bank_account') → literal('bank_account')` |

| Code | Change |  |
| --- | --- | --- |
| `us_bank_account_cannot_be_archived` | Added | `ControlledByAlternateResourceError` |
|  | Removed | `ControlledByDashboardError` |

#### 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) |
| `BankAccount`, `SettlementCurrency` | Added | [V2MoneyManagementFinancialAddressParams](/api/v2/money-management/financial-addresses/create?api-version=2026-09-30.preview#v2_create_financial_addresses) |
| `Credentials`, `Currency` | Removed | [V2MoneyManagementFinancialAddress](/api/v2/money-management/financial-addresses/object?api-version=2026-09-30.preview#v2_financial_address_object) |
| `AmountReceived` | Added | [V2MoneyManagementReceivedCredit](/api/v2/money-management/received-credits/object?api-version=2026-09-30.preview#v2_received_credit_object) |
| `OriginatingBankAccount` | Added | [V2MoneyManagementReceivedCreditBankTransfer](/api/v2/money-management/received-credits/object?api-version=2026-09-30.preview#v2_received_credit_object-bank_transfer) |
| `OriginType` | Removed | [V2MoneyManagementReceivedCreditBankTransfer](/api/v2/money-management/received-credits/object?api-version=2026-09-30.preview#v2_received_credit_object-bank_transfer) |
| `Include` | Removed | [V2MoneyManagementFinancialAddressListParams](/api/v2/money-management/financial-addresses/list?api-version=2026-09-30.preview#v2_list_financial_addresses), [V2MoneyManagementFinancialAddressParams](/api/v2/money-management/financial-addresses/retrieve?api-version=2026-09-30.preview#v2_retrieve_financial_addresses) |

| Field | Change | From → to |
| --- | --- | --- |
| `V2MoneyManagementFinancialAddressParams.Type` | Changed | `enum('gb_bank_account'|'us_bank_account') → literal('bank_account')` |

| Code | Change |  |
| --- | --- | --- |
| `us_bank_account_cannot_be_archived` | Added | `ControlledByAlternateResourceError` |
|  | Removed | `ControlledByDashboardError` |

#### .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`, `SettlementCurrency` | Added | [V2.MoneyManagement.FinancialAddressCreateOptions](/api/v2/money-management/financial-addresses/create?api-version=2026-09-30.preview#v2_create_financial_addresses) |
| `Credentials`, `Currency` | Removed | [V2.MoneyManagement.FinancialAddress](/api/v2/money-management/financial-addresses/object?api-version=2026-09-30.preview#v2_financial_address_object) |
| `AmountReceived` | Added | [V2.MoneyManagement.ReceivedCredit](/api/v2/money-management/received-credits/object?api-version=2026-09-30.preview#v2_received_credit_object) |
| `OriginatingBankAccount` | Added | [V2.MoneyManagement.ReceivedCredit.BankTransfer](/api/v2/money-management/received-credits/object?api-version=2026-09-30.preview#v2_received_credit_object-bank_transfer) |
| `OriginType` | Removed | [V2.MoneyManagement.ReceivedCredit.BankTransfer](/api/v2/money-management/received-credits/object?api-version=2026-09-30.preview#v2_received_credit_object-bank_transfer) |
| `Include` | Removed | [V2.MoneyManagement.FinancialAddressGetOptions](/api/v2/money-management/financial-addresses/retrieve?api-version=2026-09-30.preview#v2_retrieve_financial_addresses), [V2.MoneyManagement.FinancialAddressListOptions](/api/v2/money-management/financial-addresses/list?api-version=2026-09-30.preview#v2_list_financial_addresses) |

| Field | Change | From → to |
| --- | --- | --- |
| `V2.MoneyManagement.FinancialAddressCreateOptions.Type` | Changed | `enum('gb_bank_account'|'us_bank_account') → literal('bank_account')` |

| Codes | Change |  |
| --- | --- | --- |
|  | Removed | `ControlledByDashboardException` |

## 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

- [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)
- [Updates Financial Address request and response structure](https://docs.stripe.com/changelog/endive/2026-09-30/updating-financial-address-request-and-response-structure.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)