Skip to content
Create account or Sign in
The Stripe Docs logo
/
Create accountSign in

Adds alternative reference field to bank account and payout method resourcesPublic preview

What’s new

You can now view and cross-reference Payout Methods coming from External Accounts using the new alternative_reference property. This property is available for the following resources:

The new alternative_reference property follows the format {type: "external_account", id: "ba_123"}, where the ID corresponds to the External Account identifier.

Impact

You can use the alternative_reference property to trace a Payout Method back to its External Account and update the credential information as needed, without any changes to your existing integration code. This new property is read-only and automatically populates when credentials originate from External Accounts.

Changes

ParameterChangeResources or endpoints
alternative_referenceAdded
V2.Core.Vault.GbBankAccountV2.Core.Vault.UsBankAccountV2.MoneyManagement.PayoutMethod

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: 2026-01-28.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.

Related changes