Public preview
Adds the Stripe profiles API to represent public business identities on Stripe Public preview
What’s new
Adds the Business Profiles API for retrieving information about business profiles on the Stripe network. Use the me method to retrieve your own Stripe profile, or the retrieve method to look up another business by their network ID.
Businesses on the Stripe network have a profile with a network ID ( profile_1234), a human-readable profile handle (@example) and business details like display name and URL.
Impact
You can now retrieve information about business profiles on the Stripe network.
Network IDs are stable identifiers that never change, even if a business updates their profile handle. Always use network IDs when referencing profiles across other Stripe APIs.
Business profiles are needed when using the Shared Payment Token (SPT) and Orchestrated Commerce Agreement (OCA) APIs, where agents and sellers exchange network IDs to establish data-sharing permissions.
Changes
| Change | Resource | |
|---|---|---|
| Added | V2. Network. BusinessProfile | |
| Endpoints | Change | Resource |
| me retrieve | Added | V2. Network. BusinessProfile |
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-04-22. preview
- Upgrade the API version used for webhook endpoints .
- Test your integration against the new version.
- If you use Connect, test your Connect integration .
Learn more about Stripe API upgrades.
