Adds field-level permissions for revenue and worker count in an Account's business profile
What’s new
Adds undefined as a possible value for the Account.business_profile.annual_revenue and Account.business_profile.estimated_worker_count parameters in Accounts API responses.
Previously, Account.business_profile.annual_revenue and Account.business_profile.estimated_worker_count contained null or a value. This change allows the API to return undefined, null, or a value. This affects all API endpoints that return the Account object.
Impact
This change allows you to differentiate how you handle responses returning the business_profile of an Account object. You can update your integration to handle the response differently depending on whether the annual_revenue and estimated_worker_count parameters return null or undefined.
Even if you don’t handle the values differently, update your integration to expect either value to make sure your integration remains compatible with all possible API responses and prevents potential errors when processing Account data.
Changes
| Fields | Change | From → to |
|---|---|---|
| Account. business_profile. annual_revenue Account. business_profile. estimated_worker_count | Changed | required → optional |
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: 2024-12-18. acacia
- 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.
