Breaking changes
Public preview

Removes the source type property from Stripe balance payment methods Breaking changes Public preview

What’s new

Removes the source_type property from API resources that reference a Payment Method with a type of stripe_balance.

The source_type property can appear in different hashes, depending on the resource. For example, in the Payment Record object, the removed property is payment_method_details.stripe_balance.source_type, and in the create /v1/payment_methods method, the removed parameter is stripe_balance.source_type.

Why is this a breaking change?

Stripe balance payment methods no longer support the source_type property. If your integration references the source_type property for Stripe balance payments, you must remove it from your code.

Requests that include the source _ type parameter for Stripe balance payments now fail with a parameter _ unknown error.
Responses and objects for Stripe balance payments no longer include the source _ type property.

Impact

This change only affects integrations using Stripe balance payments. It removes the source_type property from the following resources when they represent Stripe balance payments:

Charges
Confirmation Tokens
Payment Attempt Records
Payment Intents
Payment Methods
Payment Records
Setup Intents

You can no longer include the source_type parameter when calling any endpoints of the affected resources for a Stripe balance payment. You can no longer reference the source_type property in objects or responses of the affected resources when they’re associated with a Stripe balance payment.

No action is needed if you don’t use the stripe_balance payment method.

Changes

Parameter	Change	Resources or endpoints
source_type	Removed	Charge. payment_method_details. stripe_balance ConfirmationToken. payment_method_preview. stripe_balance ConfirmationToken. testHelpers#create. payment_method_data. stripe_balance + 10 more PaymentAttemptRecord. payment_method_details. stripe_balance PaymentIntent#confirm. payment_method_data. stripe_balance PaymentIntent#create. payment_method_data. stripe_balance PaymentIntent#update. payment_method_data. stripe_balance PaymentMethod#create. stripe_balance PaymentMethod. stripe_balance PaymentRecord. payment_method_details. stripe_balance SetupIntent#confirm. payment_method_data. stripe_balance SetupIntent#create. payment_method_data. stripe_balance SetupIntent#update. payment_method_data. stripe_balance

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: 2026-03-25. 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.