Skip to content
Create account or Sign in
The Stripe Docs logo
/
Ask AI
Create accountSign in
Get started
Payments
Revenue
Platforms and marketplaces
Money management
Developer resources
APIs & SDKsHelp
Overview
Versioning
Changelog
    Overview
    Dahlia
    Clover
    Basil
    Acacia
    Previous versions
Upgrade your API version
Upgrade your SDK version
Essentials
SDKs
API
Testing
Stripe CLI
Stripe Projects
Tools
Stripe Dashboard
Workbench
Developers Dashboard
Stripe for Visual Studio Code
Terraform
Stripe Discord server
Features
Workflows
Batch jobs
Event destinations
Stripe health alertsStripe SignalsFile uploads
AI solutions
Model Context ProtocolAgent skillsStripe Directory
Extend Stripe
Overview
Build Stripe apps
Use apps from Stripe
Build extensions
Custom objects
Security and privacy
Security
Activity logsStripebot web crawler
Privacy
Partners
Partner ecosystem
Partner certification
United States
English (United States)
  1. Home/
  2. Developer resources/
  3. Changelog/
  4. Dahlia/
  5. 2026-03-25.dahlia
Breaking changes

Adds risk requirements to the Capabilities APIBreaking changes

What’s new

Adds risk requirements to the requirements hash of the Capability object.

Previously, risk requirements only appeared in the requirements and future_requirements hashes of the Account object. In the Accounts v1 API, those hashes don’t identify the capabilities that a particular requirement affects.

Why is this a breaking change?

The Capability object’s requirements hash can now contain risk-related requirements. If your integration assumes that it doesn’t include them, you might need to update your code.

Impact

When using the Accounts v1 API, you can now programmatically identify capabilities that are or can be affected by risk requirements by using the Capabilities API.

If you use the Accounts v2 API, you don’t need to use the Capabilities API. In Accounts v2, each entry in the requirements and future_requirements hashes includes an impact.restricts_capabilities array listing the capabilities affected by that requirement.

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-03-25.dahlia
  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.

Related changes

  • Removes the requirement for certain connected accounts to collect external account information in the Account Sessions API
Was this page helpful?
YesNo
  • Need help? Contact Support.
  • Chat with Stripe developers on Discord.
  • Check out our changelog.
  • Questions? Contact Sales.
  • LLM? Read llms.txt.
  • Powered by Markdoc
On this page