Public preview

Makes Accounts v2 available to all Stripe users for managing customers Public preview

What’s new

The Accounts v2 API is now available in public preview for all Stripe users, extending its availability beyond Connect platforms.

You can use /the relevant part of the product with the customer configuration to represent customers using Account objects. After you enable the preview, Stripe automatically makes your existing Customer objects available as Account objects with the customer configuration, and keeps newly created Accounts or Customer objects interoperable.

After opting in, new customers created in the Dashboard and through Stripe-hosted checkout flows create customer-configured Account objects instead of Customer objects.

Learn more about representing customers using Account objects.

Impact

This change affects merchants who want to use Accounts v2 to represent customers, and Connect platforms who want to sync existing Customer objects with Account v2 objects.

You can continue using the Customers API, since Stripe maintains interoperability between synced Customer and Account v2 objects. Supported v1 APIs accept customer_account in addition to customer.

Opting out stops new automatic syncing, but doesn’t undo changes to existing Customer objects that are already associated with Account objects. Some customer features remain unsupported in preview. See the preview guide for current limitations and opt-out behavior.

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

3. Upgrade the API version used for webhook endpoints .
4. Test your integration against the new version.
5. If you use Connect, test your Connect integration .
6. In Workbench, perform the upgrade . You can roll back the version for 72 hours.

Learn more about Stripe API upgrades.