apiwatch

All changes / Stripe

Breaking rest

In Stripe's public preview API version 2026-10-28.preview, creating a v2 Financial Address no longer accepts settlement_currency, and the response always includes it

Took effect · Stripe API 2026-10-28.preview (public preview) — settlement_currency removed from v2 Financial Address create, required in the response

Reviewed against the vendor source on Oct 31, 2026 (AI-assisted review). Key facts are re-checked against the source daily.

What changes

This applies only to callers on the public preview version 2026-10-28.preview, or on the preview SDKs that pin it (stripe-python 16.2.0b1, stripe-node 23.2.0-beta.1). Stripe removes the settlement_currency parameter from create a Financial Address requests and classes this as a breaking change. settlement_currency becomes required in the Financial Address response, defaulting to the associated bank account's currency, so reading it keeps working. Attribute reads (obj.settlement_currency) are not flagged; only create parameters need to change.

Breaking: Calls fail after this date.

What to do

Before moving to 2026-10-28.preview, stop passing settlement_currency when you create a v2 Financial Address. Read settlement_currency from the response instead; it defaults to the associated bank account's currency.

Strings to search for

settlement_currencysettlementCurrencySettlementCurrencysetSettlementCurrency

Not affected (matches inside these are ignored): .settlement_currency, .SettlementCurrency, ->settlement_currency, getSettlementCurrency

Counts only in files that mention money_management + financial_addresses.create or moneymanagement + financialaddresses.create or moneymanagement + financialaddresses->create or moneymanagement + financialaddresscreateparams or money_management + financialaddresscreateparams or moneymanagement + financialaddresscreateoptions or v2moneymanagementfinancialaddressparams or v2/money_management/financial_addresses + post; repos that depend on stripe 16.2.0b.x (pypi) or stripe 23.2.0-beta.x (npm); or repos that mention 0.preview or 1.preview or 2.preview or 3.preview or 4.preview or 5.preview or 6.preview or 7.preview or 8.preview or 9.preview (including dependency manifests).

Source

https://docs.stripe.com/changelog/endive/2026-10-28/financial-addresses-settlement-currency.md