# Adds settlement currency management to Balance Settings ## What’s new Adds two properties to the [payments](https://docs.stripe.com/api/balance-settings/object.md?api-version=2026-10-28.preview#balance_settings_object-payments) hash on the [Balance Settings](https://docs.stripe.com/api/balance-settings/object.md?api-version=2026-10-28.preview) object: - [settlement_currencies](https://docs.stripe.com/api/balance-settings/object.md?api-version=2026-10-28.preview#balance_settings_object-payments-settlement_currencies): A hash of settlement currencies and their states. Each key is an ISO 4217 currency code, and each value is `enabled`, `disabled`, or `restricted_by_application`. When updating Balance Settings, you can set currencies to `enabled` or `disabled`. - [default_settlement_currency](https://docs.stripe.com/api/balance-settings/object.md?api-version=2026-10-28.preview#balance_settings_object-payments-default_settlement_currency): The account’s default settlement currency. This property is always present in the response. These properties let [Connect](https://docs.stripe.com/connect.md) platforms manage [multi-currency settlement](https://docs.stripe.com/connect/multi-currency-settlement.md) for connected accounts through the API, without requiring an external bank account for each currency. If you’re not a Connect platform, use these properties to manage [multi-currency settlement](https://docs.stripe.com/payouts/multi-currency-settlement.md) for your own account. ## Impact If you’re a Connect platform, use the `settlement_currencies` and `default_settlement_currency` properties on the Balance Settings object to manage [multi-currency settlement](https://docs.stripe.com/connect/multi-currency-settlement.md) for connected accounts. You can enable or disable settlement currencies and view an account’s default settlement currency. If you’re not a Connect platform, use the same properties to manage [multi-currency settlement](https://docs.stripe.com/payouts/multi-currency-settlement.md) for your own account. ## Changes #### REST API | Parameters | Change | Resources or endpoints | | --- | --- | --- | | `settlement_currencies` | Added | [BalanceSettings#update.payments](/api/balance-settings/update?api-version=2026-10-28.preview#update_balance_settings-payments) | | `default_settlement_currency`, `settlement_currencies` | Added | [BalanceSettings.payments](/api/balance-settings/object?api-version=2026-10-28.preview#balance_settings_object-payments) | #### Ruby | Parameters | Change | Resources or methods | | --- | --- | --- | | `default_settlement_currency`, `settlement_currencies` | Added | [BalanceSettings::Payments](/api/balance-settings/object?api-version=2026-10-28.preview#balance_settings_object-payments) | | `settlement_currencies` | Added | [BalanceSettingsUpdateParams::Payments](/api/balance-settings/update?api-version=2026-10-28.preview#update_balance_settings-payments) | #### Python | Parameters | Change | Resources or methods | | --- | --- | --- | | `default_settlement_currency`, `settlement_currencies` | Added | [BalanceSettings.Payments](/api/balance-settings/object?api-version=2026-10-28.preview#balance_settings_object-payments) | | `settlement_currencies` | Added | [BalanceSettingsModifyParamsPayments](/api/balance-settings/update?api-version=2026-10-28.preview#update_balance_settings-payments) | #### PHP | Parameters | Change | Resources or methods | | --- | --- | --- | | `default_settlement_currency`, `settlement_currencies` | Added | [BalanceSettings.payments](/api/balance-settings/object?api-version=2026-10-28.preview#balance_settings_object-payments) | | `settlement_currencies` | Added | [BalanceSettings.update().$params.payment](/api/balance-settings/update?api-version=2026-10-28.preview#update_balance_settings-payments) | #### Java | Parameters | Change | Resources or methods | | --- | --- | --- | | `defaultSettlementCurrency`, `settlementCurrencies` | Added | [BalanceSettings.payments](/api/balance-settings/object?api-version=2026-10-28.preview#balance_settings_object-payments) | | `settlementCurrencies` | Added | [BalanceSettingsUpdateParams.payments](/api/balance-settings/update?api-version=2026-10-28.preview#update_balance_settings-payments) | #### Node.js | Parameters | Change | Resources or methods | | --- | --- | --- | | `settlement_currencies` | Added | [BalanceSettingsUpdateParams.payments](/api/balance-settings/update?api-version=2026-10-28.preview#update_balance_settings-payments) | | `default_settlement_currency`, `settlement_currencies` | Added | [BalanceSettings.payments](/api/balance-settings/object?api-version=2026-10-28.preview#balance_settings_object-payments) | #### Go | Parameters | Change | Resources or methods | | --- | --- | --- | | `DefaultSettlementCurrency`, `SettlementCurrencies` | Added | [BalanceSettingsPayments](/api/balance-settings/object?api-version=2026-10-28.preview#balance_settings_object-payments) | | `SettlementCurrencies` | Added | [BalanceSettingsPaymentsParams](/api/balance-settings/update?api-version=2026-10-28.preview#update_balance_settings-payments) | #### .NET | Parameters | Change | Resources or methods | | --- | --- | --- | | `DefaultSettlementCurrency`, `SettlementCurrencies` | Added | [BalanceSettings.Payments](/api/balance-settings/object?api-version=2026-10-28.preview#balance_settings_object-payments) | | `SettlementCurrencies` | Added | [BalanceSettingsPaymentsOptions](/api/balance-settings/update?api-version=2026-10-28.preview#update_balance_settings-payments) | ## 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-10-28.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 - [Adds support for the Wero bank redirect payment method](https://docs.stripe.com/changelog/endive/2026-10-28/wero-bank-redirect-payment-method-support.md) - [Adds Plaid processor tokens for ACH Direct Debit payment methods](https://docs.stripe.com/changelog/endive/2026-10-28/us-bank-account-external-token-parameter-support.md) - [Adds fingerprint properties to v2 bank account objects](https://docs.stripe.com/changelog/endive/2026-10-28/v2-bank-account-fingerprint-properties.md)