apiwatch

All changes / Stripe

Breaking rest

In Stripe's public preview API version 2026-10-28.preview, v2 Financial Address bank account details drop last4 (ABA, IBAN, sort code), rename ABA account_holder_address to address, and move IBAN country to the parent bank_account

Took effect · Stripe API 2026-10-28.preview (public preview) — v2 Financial Address bank_account details: last4 removed, aba account_holder_address renamed to address, iban country moved to bank_account

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), who use the v2 Financial Addresses API. last4 no longer exists on ABA, IBAN or sort code details; account_holder_address on ABA details is now address; country moves from IBAN details to the parent bank_account object. account_number (ABA, sort code) and iban (IBAN) become required. Stripe classes this as a breaking change. Only access paths such as aba.last4, aba?.last4, aba->last4 and getAba().getLast4() are matched for the generic names, so dictionary-style reads of last4 or country are not flagged.

Breaking: Calls fail after this date.

What to do

Before moving to 2026-10-28.preview, read bank_account.aba.address instead of account_holder_address, read country from bank_account instead of bank_account.iban, remove reads of last4 on aba, iban and sort_code details, and treat account_number and iban as always present.

Strings to search for

account_holder_addressaccountHolderAddressAccountHolderAddressaba.last4iban.last4sort_code.last4iban.countryAba.Last4Iban.Last4SortCode.Last4Iban.Countryaba?.last4iban?.last4sort_code?.last4iban?.countryaba->last4iban->last4sort_code->last4iban->countrygetAccountHolderAddressgetAba().getLast4getIban().getLast4getSortCode().getLast4getIban().getCountry

Counts only in files that mention financial_address + money_management or financialaddress + money_management or financialaddress + moneymanagement or financial_address + moneymanagement; 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-v2-api-shape-updates.md