Public preview
Adds alternative reference field to bank account and payout method resources Public 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:
- GbBankAccount
- UsBankAccount
- PayoutMethod
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
| Parameter | Change | Resources or endpoints |
|---|---|---|
| alternative_reference | Added | V2. Core. Vault. GbBankAccount V2. Core. Vault. UsBankAccount V2. MoneyManagement. PayoutMethod |
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-01-28. preview
- Upgrade the API version used for webhook endpoints .
- Test your integration against the new version.
- If you use Connect, test your Connect integration .
Learn more about Stripe API upgrades.