Adds Balance Transaction types for provisional credits for Issuing disputes
What’s new
Adds two values to the type property of Balance Transactions to represent money movement related to provisional credits for Issuing disputes:
issuing_represents a temporary credit granted to the Issuing balance when a dispute is submitted.dispute_ provisional_ credit issuing_represents the reversal of that provisional credit at dispute resolution.dispute_ provisional_ credit_ reversal
Both values are available as filters when you list Balance Transactions. Each type has a corresponding reporting_category for differentiation in Balance Reports. The existing issuing_ type continues to represent the final credit for a won dispute.
Impact
If your integration filters or processes Balance Transactions by type, you might encounter the issuing_ and issuing_ values in API responses. These values also appear in SDK type definitions and OpenAPI specs. To adapt your integration:
- Update any code that depends on
typeto handle the two additional values, especially if your code raises errors on unrecognized types. - If applicable, adjust reconciliation workflows to use these new types to distinguish provisional credit movements from final dispute credits.
- Review Balance reports that rely on reporting categories, because each type has its own corresponding
reporting_.category
Changes
| Values | Change | Enum |
| issuing_dispute_provisional_creditissuing_dispute_provisional_credit_reversal | Added |
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-09-30.endive
- If you don’t use an SDK, update your API requests to include
- 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.