← Back
Stripe
Stripe removes source_type property from balance payment methods
Stripe APIStripe · apibreaking-changerelease · docs.stripe.com ↗

Breaking Change: source_type Property Removed

Stripe has removed the source_type property from all API resources that reference a Payment Method with type stripe_balance. This is a breaking change that requires action from developers using Stripe balance payments.

What Changed

The source_type property has been removed from the following API resources when representing Stripe balance payments:

  • Chargespayment_method_details.stripe_balance.source_type
  • Confirmation Tokens — corresponding property in balance payment details
  • Payment Attempt Records — balance payment method details
  • Payment Intents — balance payment method information
  • Payment Methods — stripe_balance object parameters
  • Payment Recordspayment_method_details.stripe_balance.source_type
  • Setup Intents — balance payment configuration

Action Required

If your integration uses Stripe balance payments, you must:

  1. Remove all references to the source_type parameter from API requests when creating or updating Stripe balance payment methods
  2. Update response handling to remove any code that reads the source_type property from returned objects
  3. Expect new errors — requests that include source_type for Stripe balance payments will now fail with a parameter_unknown error

Upgrade Path

To adopt this change:

  1. View your current API version in Workbench
  2. Upgrade to SDK version 2026-03-25.preview (or update the Stripe-Version header for non-SDK integrations)
  3. Remove all source_type references from your Stripe balance payment code
  4. Test your integration against the new API version
  5. Upgrade webhook endpoints to use the new API version
  6. Perform the upgrade in Workbench (with 72-hour rollback available)

Note: This change only affects integrations using Stripe balance payments. No action is required if you don't use the stripe_balance payment method.