Adds new error codes for failures when creating Payment Methods from Financial Connections Accounts
What’s new
When you create a us_bank_account Payment Method from a Financial Connections Account using the financial_connections_account parameter, the account might not yet have account or routing numbers, or Stripe might still be retrieving them. In these cases, Stripe returns one of the following error codes:
- financial _ connections _ account _ pending _ account _ numbers : If you receive this error, retry the request later.
- financial _ connections _ account _ unavailable _ account _ numbers : If you receive this error, prompt your user to link a different bank account.
Impact
Previously, this error didn’t include a specific error code and appeared as an invalid request. Use the new error code to decide whether to retry creating the PaymentMethod.
Changes
| Codes | Change | |
|---|---|---|
| financial_connections_account_pending_account_numbers financial_connections_account_unavailable_account_numbers | Added | Invoice. last_finalization_error PaymentIntent. last_payment_error SetupAttempt. setup_error + 2 more SetupIntent. last_setup_error StripeError |
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: 2025-09-30. clover
- 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.