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.
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).