Breaking Change to Accounts v2 Identity Properties

Stripe has implemented restrictions on identity properties within the Accounts v2 API for Global Payouts users. Certain identity properties are no longer accessible when:

• An Account is configured for only Global Payouts capabilities
• An Account has no requested capabilities
• An Account has defaults.responsibilities.requirements_collector set to stripe

What's Restricted

The following changes take effect with API version 2026-03-25.preview:

• Terms of Service Attestation: You can no longer set identity.attestations.terms_of_service on Accounts that only request Global Payouts capabilities, as these accounts don't sign the Stripe Terms of Service
• Account-specific restrictions: Accounts with no requested capabilities or where Stripe handles requirements collection will have restricted access to various identity properties

Required Actions

If your Global Payouts integration reads or writes identity properties, you must:

1. Review code that accesses identity hash properties on Account objects
2. Remove any attempts to read or write properties that are no longer available for your account configuration
3. Update SDK or API version headers to Stripe-Version: 2026-03-25.preview (or upgrade to the corresponding SDK version)
4. Test your integration thoroughly in the Stripe test environment
5. Perform the upgrade in Workbench—you have 72 hours to roll back if needed

Refer to the Accounts API v2 documentation for the complete list of restricted properties.