Adds new address fields to Accounts v2 for Singapore compliance
What’s new
Adds the additional_addresses property to the identity.business_details hash of the v2 Account object. This property contains the business’s principal place of business and administrative address. Set each address’s purpose to principal_place_of_business or administrative.
You can optionally provide the additional_addresses parameter when you create or update a v2 Account, or create an Account Token.
Impact
If you use API-based onboarding for Singapore connected accounts, update your integration to pass additional_addresses with the applicable purpose values when required. For implementation guidance, see Upcoming requirement updates for Singapore.
Unless it’s required for you, additional_addresses is optional and doesn’t affect existing requests.
Changes
| Parameter | Change | Resources or endpoints |
|---|---|---|
| additional_addresses | Added | V2. Core. Account#create. identity. business_details V2. Core. Account#update. identity. business_details V2. Core. Account. identity. business_details + 1 more V2. Core. AccountToken#create. identity. business_details |
Upgrade
- View your current API version in Workbench.
- 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 to include Stripe-Version: 2026-07-29. dahlia
- Upgrade the API version used for webhook endpoints .
- Test your integration against the new version.
- If you use Connect, test your Connect integration .
- In Workbench, perform the upgrade . You can roll back the version for 72 hours.
Learn more about Stripe API upgrades.
Related changes
- Adds the ability to show who initiated a top-up
- Adds Payment Method support to Top-ups
- Adds new address fields to Accounts v1 for Singapore compliance
- Adds a new Smart Disputes management feature to Account Session embedded components
- Enables rejecting connected accounts with non-zero balances and controlling whether to pause payouts
- Adds the ability to reverse platform rejections on connected accounts