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
    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
Terraform
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
Extend Stripe
Build Stripe apps
Use apps from Stripe
Partners
Partner ecosystem
Partner certification
United States
English (United States)
HomeDeveloper resourcesChangelogClover2026-01-28.preview

Updates error codes for the Outbound Setup Intents APIBreaking changes

What’s new

Updates the error codes returned by the Outbound Setup Intents API to use more generic error types instead of credential-type-specific codes. This change replaces several existing error codes with standardized error types:

  • blocked_payout_method_bank_account, blocked_payout_method_card, and blocked_payout_method_crypto_wallet errors now return blocked_payout_method.
  • unsupported_payout_method_bank_account and unsupported_payout_method_card errors now return unsupported_payout_method.
  • invalid_payout_method_bank_account, invalid_payout_method_card, and invalid_payout_method_crypto_wallet errors now return invalid_payout_method.
  • limit_payout_method_bank_account, limit_payout_method_card, and limit_payout_method_crypto_wallet errors now return limit_payout_method.

This standardization improves the consistency of error handling across different Payout Method types and supports future extensibility when adding new credential types to Payout Methods.

Why is this a breaking change?

This is a breaking change because your integration can rely on the specific error code identifiers that this update replaces. If your code checks for type specific error codes like blocked_payout_method_bank_account, unsupported_payout_method_bank_account, invalid_payout_method_bank_account_, or limit_payout_method_bank_account, those checks no longer work and you must update them to handle the generic error types.

Impact

If your integration handles specific error codes from Outbound Setup Intents endpoints, you need to update your error handling logic to use the generic error types. The error messages and underlying reasons remain the same, but the error code identifiers have changed to be more consistent across different Payout Method types.

Changes

CodesChange
blocked_payout_methodunsupported_payout_methodAdded
blocked_by_stripe
invalid_payout_method_dataAdded
invalid_payout_method
limit_payout_methodAdded
quota_exceeded

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-01-28.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.

Related changes

  • Adds alternative reference field to bank account and payout method resources
  • Adds fingerprint property to card payout methods
  • Global Payouts adds support for 15 new countries for cross-border payouts
Was this page helpful?
YesNo
  • Need help? Contact Support.
  • Check out our changelog.
  • Questions? Contact Sales.
  • LLM? Read llms.txt.
  • Powered by Markdoc