Skip to content
Create account
or
Sign in
The Stripe Docs logo
/
Ask AI
Create account
Sign in
Get started
Payments
Finance automation
Platforms and marketplaces
Money management
Developer tools
Get started
Payments
Finance automation
Get started
Payments
Finance automation
Platforms and marketplaces
Money management
Overview
Versioning
Changelog
    Overview
    Basil
    Acacia
    Previous versions
Upgrade your API version
Upgrade your SDK version
Developer tools
SDKs
API
Testing
Workbench
Event Destinations
Workflows
Stripe CLI
Stripe Shell
Developers Dashboard
Agent toolkit
Stripe health alertsBuilding with LLMsStripe for Visual Studio CodeFile uploads
Security
Security
Extend Stripe
Stripe Apps
Stripe Connectors
Partners
Partner ecosystem
Partner certification
HomeDeveloper toolsChangelogBasil2025-04-30.preview

Adds support for Global PayoutsPublic preview

What’s new

Users in the US and UK can now send money directly to third parties using a new set of money management APIs. Global Payouts offers several integration paths with no-code, hosted, and API solutions that allow your business to send and track payouts globally without requiring you to use Stripe for payments.

Impact

We’ve introduced a new set of money management APIs:

  • Adjustments represent Stripe-initiated credits or debits to a user balance.
  • Financial Accounts are the containers that allow for the configuration of money movement.
  • Financial Addresses contain information needed to transfer money to a Financial Account.
  • Inbound Transfers represent money movement from a user owned PaymentMethod to their FinancialAccount.
  • Outbound Payments represent money movement from your FinancialAccount to a third party.
  • Outbound Transfers represent money movement from your FinancialAccount to yourself.
  • Received Credits represent funds sent into your FinancialAccount.
  • Received Debits represent funds debited from your FinancialAccount.
  • Transactions represent changes to your FinancialAccount balance over time.
  • Transaction Entries represent individual money movements across different states within a Transaction.

Additionally, you can now use Account Links to access the Stripe-hosted Recipient Onboarding application.

Changes

ChangeResources
Added
V2.Core.AccountLinkV2.FinancialAddressCreditSimulationV2.FinancialAddressGeneratedMicrodeposits
 + 16 more
V2.MoneyManagement.AdjustmentV2.MoneyManagement.FinancialAccountV2.MoneyManagement.FinancialAddressV2.MoneyManagement.InboundTransferV2.MoneyManagement.OutboundPaymentQuoteV2.MoneyManagement.OutboundPaymentV2.MoneyManagement.OutboundSetupIntentV2.MoneyManagement.OutboundTransferV2.MoneyManagement.PayoutMethodV2.MoneyManagement.PayoutMethodsBankAccountSpecV2.MoneyManagement.ReceivedCreditV2.MoneyManagement.ReceivedDebitV2.MoneyManagement.TransactionEntryV2.MoneyManagement.TransactionV2.Core.Vault.GbBankAccountV2.Core.Vault.UsBankAccount
Endpoints ChangeResources
createAdded
V2.Core.AccountLink
listretrieveAdded
V2.MoneyManagement.AdjustmentV2.MoneyManagement.FinancialAccountV2.MoneyManagement.ReceivedCredit
 + 3 more
V2.MoneyManagement.ReceivedDebitV2.MoneyManagement.TransactionEntryV2.MoneyManagement.Transaction
retrieveAdded
V2.MoneyManagement.PayoutMethodsBankAccountSpec
archivelistretrieveunarchiveAdded
V2.MoneyManagement.PayoutMethod
cancelcreatelistretrieveupdateAdded
V2.MoneyManagement.OutboundSetupIntent
cancelcreatelistretrieveAdded
V2.MoneyManagement.OutboundPaymentV2.MoneyManagement.OutboundTransfer
createretrieveAdded
V2.MoneyManagement.OutboundPaymentQuote
createlistretrieveAdded
V2.MoneyManagement.FinancialAddressV2.MoneyManagement.InboundTransfer
creditgenerate_microdepositsAdded
V2.TestHelpers.FinancialAddress
archivecreateretrieveupdateAdded
V2.Core.Vault.UsBankAccount
acknowledge_confirmation_of_payeearchivecreateinitiate_confirmation_of_payeeretrieveAdded
V2.Core.Vault.GbBankAccount
ChangeEvent types
Added
V2MoneyManagementAdjustmentCreatedEventV2MoneyManagementFinancialAccountCreatedEventV2MoneyManagementFinancialAccountUpdatedEvent
 + 31 more
V2MoneyManagementFinancialAddressActivatedEventV2MoneyManagementFinancialAddressFailedEventV2MoneyManagementInboundTransferAvailableEventV2MoneyManagementInboundTransferBankDebitFailedEventV2MoneyManagementInboundTransferBankDebitProcessingEventV2MoneyManagementInboundTransferBankDebitQueuedEventV2MoneyManagementInboundTransferBankDebitReturnedEventV2MoneyManagementInboundTransferBankDebitSucceededEventV2MoneyManagementOutboundPaymentCanceledEventV2MoneyManagementOutboundPaymentCreatedEventV2MoneyManagementOutboundPaymentFailedEventV2MoneyManagementOutboundPaymentPostedEventV2MoneyManagementOutboundPaymentReturnedEventV2MoneyManagementOutboundPaymentUpdatedEventV2MoneyManagementOutboundTransferCanceledEventV2MoneyManagementOutboundTransferCreatedEventV2MoneyManagementOutboundTransferFailedEventV2MoneyManagementOutboundTransferPostedEventV2MoneyManagementOutboundTransferReturnedEventV2MoneyManagementOutboundTransferUpdatedEventV2MoneyManagementReceivedCreditAvailableEventV2MoneyManagementReceivedCreditFailedEventV2MoneyManagementReceivedCreditReturnedEventV2MoneyManagementReceivedCreditSucceededEventV2MoneyManagementReceivedDebitCanceledEventV2MoneyManagementReceivedDebitFailedEventV2MoneyManagementReceivedDebitPendingEventV2MoneyManagementReceivedDebitSucceededEventV2MoneyManagementReceivedDebitUpdatedEventV2MoneyManagementTransactionCreatedEventV2MoneyManagementTransactionUpdatedEvent
CodesChange
already_canceledblocked_by_stripecontrolled_by_dashboardfeature_not_enabledfinancial_account_not_openinsufficient_fundsinvalid_payment_methodinvalid_payout_methodnot_cancelablequota_exceededrecipient_not_notifiableAdded
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-04-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