Skip to content
Create account
or
Sign in
The Stripe Docs logo
/
Ask AI
Create account
Sign in
Get started
Payments
Revenue
Platforms and marketplaces
Money management
Developer resources
Overview
Versioning
Changelog
    Overview
    Clover
    Basil
    Acacia
    Previous versions
Upgrade your API version
Upgrade your SDK version
Essentials
SDKs
API
Testing
Stripe CLI
Sample projects
Tools
Stripe Dashboard
Workbench
Developers Dashboard
Stripe Shell
Stripe for Visual Studio Code
Features
Workflows
Event destinations
Stripe health alertsFile uploads
AI solutions
Agent toolkit
Model Context ProtocolBuild agentic AI SaaS Billing workflows
Security and privacy
Security
Stripebot web crawler
Privacy
Extend Stripe
Build Stripe apps
Use apps from Stripe
Partners
Partner ecosystem
Partner certification
HomeDeveloper resourcesChangelogClover2025-09-30.clover

Adds specific descriptions for risk requirements during legal, PEP, and sanctions reviewBreaking changes

What’s new

Adds two new requirements, resolution paths, and a new error code for risk requirements related to legal holds, PEP reviews, and sanctions reviews. These were previously categorized as other_supportability_inquiry or other_compliance_inquiry requirements. Risk verification requirements follow the <id>.<requirement_description>.<resolution_path> format.

This update adds the:

  • external_hold error code to the requirements.errors array in the Accounts API.
  • notice resolution path to risk verification requirements.

This update also adds the following new descriptions to risk verification requirements:

  • legal_hold: We must hold funds for legal reasons. Fulfilling the requirement can involve remitting funds to a third party.
  • pep_review: We need to verify that the business isn’t involved with a person of interest or a politically exposed person.
  • sanctions_review: We need to verify that the business isn’t involved with a sanctioned person or jurisdiction.

Requirements with a description of sanctions_review or pep_review show up in pending_verification to indicate that the requirement is pending review by Stripe and doesn’t require any user action to resolve.

Why is this a breaking change?

This change will break existing integrations that aren’t updated to explicitly handle these new requirements. Sanctions, PEP review, and legal hold requirements were previously represented by the less-specific other_supportability_inquiry requirement description.

RequirementPrevious API requirementNew API requirement
Account under sanctions reviewinterv_abc123.other_supportability_request.supportinterv_abc123.sanctions_review.support
Account under PEP reviewinterv_abc123.other_supportability_request.supportinterv_abc123.pep_review.support
Account has a legal hold with additional information in the associated external_hold errorinterv_abc123.other_supportability_request.supportinterv_abc123.legal_hold.notice
Account has a legal hold without additional informationinterv_abc123.other_supportability_request.supportinterv_abc123.legal_hold.support

The following example shows a truncated response from the v1/accounts API for an account with payouts disabled due to a legal hold

{ "id": "acct_123", // ... "requirements": { "alternatives": [], "current_deadline": null, "currently_due": [ "interv_def789.legal_hold.notice" ], "disabled_reason": "requirements.past_due", "errors": [{ "requirement": "interv_def456.legal_hold.notice", "code": "external_request", "reason": "There is an active levy on this account. Ask the account to have the government agency, Llama Revenue Services, send a signed release to llg-notices@stripe.com." }], "eventually_due": [ "interv_def789.legal_hold.notice" ], "past_due": [ "interv_def789.legal_hold.notice" ], "pending_verification": [] }, "payouts_enabled": false, // ... }

This example shows a truncated response from the Accounts v1 API for an account that has payouts disabled due to both a pending sanctions and a pending PEP review

{ "id": "acct_456", // ... "requirements": { "alternatives": [], "current_deadline": null, "currently_due": [], "disabled_reason": "requirements.pending_verification", "errors": [], "eventually_due": [], "past_due": [], "pending_verification": [ "interv_def123.sanctions_review.support", "interv_def456.pep_review.support", ] }, "payouts_enabled": false, // ... }

Impact

You will gain a better understanding of capability limitations caused by sanctions reviews, PEP reviews, and legal holds and whether any action is required from you to resolve the requirement.

Changes

ValueChangeEnums
external_requestAdded
BankAccount.future_requirements.errors[]BankAccount.requirements.errors[]Account.future_requirements.errors[]
 + 5 more
Account.requirements.errors[]Capability.future_requirements.errors[]Capability.requirements.errors[]Person.future_requirements.errors[]Person.requirements.errors[]

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: 2025-09-30.clover
  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

  • Adds a new error code for business type validations
  • Adds account balance and payout settings with the Balance Settings API
Was this page helpful?
YesNo
  • Need help? Contact Support.
  • Join our early access program.
  • Check out our changelog.
  • Questions? Contact Sales.
  • LLM? Read llms.txt.
  • Powered by Markdoc