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
    Basil
    Acacia
    Previous versions
Upgrade your API version
Upgrade your SDK version
Essentials
SDKs
API
Testing
Stripe CLI
Sample projects
Tools
Workbench
Developers Dashboard
Stripe Shell
Stripe for Visual Studio Code
Features
Workflows
Event destinations
Stripe health alertsFile uploads
AI solutions
Agent toolkit
Model Context Protocol
Security and privacy
Security
Stripebot web crawler
Privacy
Extend Stripe
Build Stripe apps
Use apps from Stripe
Partners
Partner ecosystem
Partner certification
HomeDeveloper resourcesChangelogBasil2025-06-30.preview

Adds new status and consolidates error codes for money management APIsPublic preview

What’s new

This release introduces several enhancements for money management:

  • Adds a new pending status to the Financial Account resource to indicate when a Financial Account has been created and is in the process of opening.
  • Replaces the description property with metadata in the Financial Account resource.
  • Adds additional types to the balance_transfer object in the Received Credit resource.
  • Consolidates and aligns error codes for the methods to create an outbound transfer and create an outbound payment.
Old error codeNew error code
outbound_transfer_insufficient_fundsinsufficient_funds
outbound_payment_insufficient_fundsinsufficient_funds
outbound_payment_recipient_amount_limit_exceededrecipient_amount_limit_exceeded
outbound_payment_recipient_count_limit_exceededrecipient_count_limit_exceeded
outbound_payment_recipient_email_does_not_existrecipient_email_does_not_exist
outbound_payment_recipient_feature_not_activerecipient_feature_not_active

Impact

  • The new pending status provides greater visibility into Financial Account states when you’re creating accounts.
  • Replacing description with metadata allows you to associate more powerful, structured data with Financial Accounts.
  • Consolidating error codes across the methods to create an outbound transfer and create an outbound payment simplifies error management for your integration.

Changes

ParametersChangeResources or endpoints
metadataAdded
V2.MoneyManagement.FinancialAccount
descriptionRemoved
V2.MoneyManagement.FinancialAccount
from_accountoutbound_paymentoutbound_transferAdded
V2.MoneyManagement.ReceivedCredit.balance_transfer
ValueChangeEnum
pendingAdded
V2.MoneyManagement.FinancialAccount.status
FieldsChangeFrom → to
V2.MoneyManagement.ReceivedCredit.balance_transfer.typeChanged
literal('payout_v1') → enum('outbound_payment'|'outbound_transfer'|'payout_v1')
V2.MoneyManagement.ReceivedCredit.balance_transfer.payout_v1Changed
string → nullable(string)
CodesChange
storer_capability_missingstorer_capability_not_activeAdded
Error.code
insufficient_fundsAdded
Error.code
outbound_payment_insufficient_fundsoutbound_transfer_insufficient_fundsRemoved
Error.code
recipient_amount_limit_exceededrecipient_count_limit_exceededAdded
Error.code
outbound_payment_recipient_amount_limit_exceededoutbound_payment_recipient_count_limit_exceededRemoved
Error.code
recipient_email_does_not_existAdded
Error.code
outbound_payment_recipient_email_does_not_existRemoved
Error.code
recipient_feature_not_activeAdded
Error.code
outbound_payment_recipient_feature_not_activeRemoved
Error.code

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-06-30.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.

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