New Properties Added

Stripe has expanded the bank account identification details available in payout method responses by adding two new properties to the bank_account hash on the Payout Method object:

• swift_code: The bank's SWIFT or BIC code, enabling international bank identification
• branch_number: The branch identifier for the bank account

Both properties return null when the information isn't available or doesn't apply to the bank account.

Developer Impact

These additions enable developers working with cross-border payments to access more comprehensive bank account details directly from API responses. This is particularly valuable for:

• International payment reconciliation: SWIFT codes are essential for cross-border wire transfers
• Enhanced payout data: Branch numbers provide additional granularity for multi-branch banking institutions
• Compliance and audit trails: More detailed bank identification supports regulatory requirements

Upgrade Path

To access these new properties, developers must upgrade to the 2026-02-25.preview API version. The upgrade process includes:

1. Viewing your current API version in Workbench
2. Upgrading the relevant SDK (Ruby, Python, PHP, Java, Node.js, Go, or .NET) to the latest version, or updating REST API requests with the Stripe-Version: 2026-02-25.preview header
3. Updating webhook endpoint API versions
4. Testing against the new version, including Connect integrations if applicable
5. Performing the upgrade in Workbench (with a 72-hour rollback window if needed)

Learn more about Stripe API upgrades.