Public preview
Adds error codes for Financial Account capability errors Public preview
What’s new
Adds two error codes for the /v1/payouts endpoint when using a financial account as the payout_method:
- financial_account_capability_not_enabled : Returned when the required capabilities aren’t enabled for the operation. Request the required capabilities on the connected account before retrying.
- financial_account_capability_restricted : Returned when the required capabilities are restricted for the operation. Fulfill any outstanding account requirements before retrying.
Previously, these operations returned storer_capability_missing and storer_capability_not_active error codes. Starting with API version 2026-06-24.preview, they’re replaced by financial_account_capability_not_enabled and financial_account_capability_restricted respectively.
Why is this a breaking change?
If your integration handles the storer_capability_missing or storer_capability_not_active error codes, you must update your error-handling logic to use financial_account_capability_not_enabled and financial_account_capability_restricted respectively when upgrading to API version 2026-06-24.preview or later. Integrations on earlier API versions continue to receive the previous error codes without any changes required.
Impact
If your integration checks for storer_capability_missing or storer_capability_not_active in error responses, update your code to handle financial_account_capability_not_enabled and financial_account_capability_restricted instead. Integrations that don’t explicitly handle these error codes by name are unaffected.
Changes
| Codes | Change | |
|---|---|---|
| financial_account_capability_not_enabled financial_account_capability_restricted | Added | Invoice.last_finalization_error PaymentIntent.last_payment_error SetupAttempt.setup_error + 3 more SetupIntent.last_setup_error StripeError Terminal.Reader.action.api_error |
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-06-24. preview
- 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.