Stripe | Financial Infrastructure to Grow Your Revenue

Stripe | Financial Infrastructure to Grow Your Revenue

5282 articles

Adds the Stripe profiles API to represent public business identities on Stripe


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

ChangeResource
AddedV2. Network. BusinessProfile
EndpointsChangeResource
me retrieveAddedV2. Network. BusinessProfile

Upgrade

  1. View your current API version in Workbench.
  2. 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
  1. Upgrade the API version used for webhook endpoints .
  2. Test your integration against the new version.
  3. If you use Connect, test your Connect integration .

Learn more about Stripe API upgrades.

Last verified 2026-09-25

Is this helpful?