Payouts are now a capabilityBreaking changes

What’s new

We’ve made payouts a capability in both the merchant and recipient configurations. These are automatically requested when Stripe creates a Stripe balance for the account. A Stripe balance is created when you apply the Merchant configuration or request the stripe_balance.stripe_transfers capability on the Recipient configuration. You can use this capability to check that funds in the connected account’s Stripe balance can be paid out to their external account.

Learn more about the Accounts v2 public preview for Stripe Connect and Billing.

Why is this a breaking change?

We’ve removed requirements.entries.impact.restricts_payouts. Payout restrictions are now listed in requirements.entries.impact.restricts_capabilities.capability.

Impact

Requirements that impact payouts no longer have the impact.restricts_payouts field. Instead, the impact.restricts_capabilities field includes the payouts capability on the Merchant or Recipient configurations.

Changes

	Change	Resources
	Added	V2.Core.Account V2.Core.Person BalanceSettings + 1 more ExternalAccount
Endpoints	Change	Resources
closecreatelistretrieveupdate	Added	V2.Core.Account
createdellistretrieveupdate	Added	V2.Core.Person
retrieveupdate	Added	BalanceSettings
createdeletelistretrieveupdate	Added	ExternalAccount
Parameters	Change	Resources or endpoints
customer_account	Added	Billing.CreditBalanceSummary#retrieve Billing.CreditBalanceSummary Billing.CreditBalanceTransaction#list + 57 more Billing.CreditGrant#create Billing.CreditGrant#list Billing.CreditGrant BillingPortal.Session#create BillingPortal.Session CashBalance Checkout.Session#create Checkout.Session#list Checkout.Session ConfirmationToken.payment_method_preview CreditNote#list CreditNote CustomerBalanceTransaction CustomerCashBalanceTransaction CustomerSession#create CustomerSession Customer Discount FinancialConnections.Account#list.account_holder FinancialConnections.Account.account_holder FinancialConnections.Session#create.account_holder FinancialConnections.Session.account_holder Invoice#create_preview Invoice#create Invoice#list InvoiceItem#create InvoiceItem#list InvoiceItem Invoice PaymentIntent#create PaymentIntent#list PaymentIntent#update PaymentIntent PaymentMethod#attach PaymentMethod PromotionCode#create PromotionCode#list PromotionCode Quote#create Quote#list Quote#update QuotePreviewInvoice QuotePreviewSubscriptionSchedule Quote SetupAttempt SetupIntent#create SetupIntent#list SetupIntent#update SetupIntent Subscription#create Subscription#list SubscriptionSchedule#create SubscriptionSchedule#list SubscriptionSchedule Subscription TaxId.owner TaxId
related_customer_account	Added	Identity.VerificationSession#create Identity.VerificationSession#list Identity.VerificationSession
	Change	Event types
	Added	V2CoreAccountClosedEvent V2CoreAccountCreatedEvent V2CoreAccountIncludingConfigurationCustomerCapabilityStatusUpdatedEvent + 13 more V2CoreAccountIncludingConfigurationCustomerUpdatedEvent V2CoreAccountIncludingConfigurationMerchantCapabilityStatusUpdatedEvent V2CoreAccountIncludingConfigurationMerchantUpdatedEvent V2CoreAccountIncludingConfigurationRecipientCapabilityStatusUpdatedEvent V2CoreAccountIncludingConfigurationRecipientUpdatedEvent V2CoreAccountIncludingDefaultsUpdatedEvent V2CoreAccountIncludingIdentityUpdatedEvent V2CoreAccountIncludingRequirementsUpdatedEvent V2CoreAccountUpdatedEvent V2CoreAccountPersonCreatedEvent V2CoreAccountPersonDeletedEvent V2CoreAccountPersonUpdatedEvent balance_settings.updated

Upgrade

View your current API version in Workbench.
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
Upgrade the API version used for webhook endpoints.
Test your integration against the new version.
If you use Connect, test your Connect integration.
In Workbench, perform the upgrade. You can roll back the version for 72 hours.

Learn more about Stripe API upgrades.