Skip to content
Create account or Sign in
The Stripe Docs logo
Search/Ask AI
Create accountSign in
  • Get started
  • Payments
  • Revenue
  • Risk
  • Data
  • Money management
  • Stablecoins
  • Embedded finance
  • Developer resources
More
APIs & SDKsHelp
Overview
Versioning
Changelog
    Endive
    Dahlia
    Clover
    Basil
    Acacia
    Previous versions
Upgrade your integrationHow API versioning works
Essentials
SDKs
API
Events
Testing
Stripe CLI
Tools
Stripe Dashboard
Stripe Projects
Provisioning
Workbench
Developers Dashboard
Stripe for Visual Studio Code
Terraform
Stripe Discord server
Features
Workflows
Batch jobs
Stripe health alertsFile uploads
AI tools
Agent pluginsModel Context ProtocolAgent skillsStripe Directory
Extend Stripe
Overview
Build Stripe apps
Use apps from Stripe
Build extensions
Custom objects
Security and privacy
Security
Activity logsStripebot web crawler
Privacy
Partners
Partner ecosystem
Partner certification
United States
English (United States)
  1. Home/
  2. Developer resources/
  3. Changelog/
  4. Endive/
  5. 2026-09-30.endive

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_dispute_provisional_credit represents a temporary credit granted to the Issuing balance when a dispute is submitted.
  • issuing_dispute_provisional_credit_reversal represents the reversal of that provisional credit at dispute resolution.

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_dispute 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_dispute_provisional_credit and issuing_dispute_provisional_credit_reversal 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 type to 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

ValuesChangeEnum
issuing_dispute_provisional_creditissuing_dispute_provisional_credit_reversalAdded
BalanceTransaction.type

Upgrade

  1. View your current API version in Workbench.
  2. 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
  3. Upgrade the API version used for webhook endpoints.
  4. Test your integration against the new version.
  5. If you use Connect, test your Connect integration.

Learn more about Stripe API upgrades.

Was this page helpful?
YesNo
  • Need help? Contact Support.
  • Chat with Stripe developers on Discord.
  • Check out our changelog.
  • Questions? Contact Sales.
  • LLM? Read llms.txt.
  • Powered by Markdoc
On this page