Stripe Balance Transactions add Issuing provisional credit types
Introduced 2026-09-30 · score 0.94
HOW TO USE IT
If your integration filters or processes Balance Transaction `type` values, handle `issuing_dispute_provisional_credit` and `issuing_dispute_provisional_credit_reversal`. Use those types to distinguish provisional credit movements during reconciliation, and review Balance Reports that use `reporting_category`.
curl -G https://api.stripe.com/v1/balance_transactions -u "<secret_key>:" -d "type=issuing_dispute_provisional_credit"curl -G https://api.stripe.com/v1/balance_transactions -u "<secret_key>:" -d "type=issuing_dispute_provisional_credit_reversal"WHY THIS HELPS
Update an integration that filters or processes Stripe Balance Transactions by type to handle provisional credits for Issuing disputes.
REQUIREMENTS AND LIMITATIONS
- type: Filters the list to transactions of the given type; the release note adds the two provisional-credit values listed above.
- reporting_category: Balance Transaction categorization used by Balance Reports; the two new values each have a corresponding category for differentiation.
- The new values concern money movement related to provisional credits for Issuing disputes.
- The existing `issuing_dispute` type continues to represent the final credit for a won dispute.
- Both new values are available as filters when listing Balance Transactions.
- Each new type has a corresponding `reporting_category` for differentiation in Balance Reports.
- The values also appear in SDK type definitions and OpenAPI specs.
- Docs conflict: The accessible current API reference omits the two new types from its documented enum, although the release note for API version 2026-09-30.endive states they are valid list filters. Used the release note for those values; do not rely on the current enum list.
FIRST-PARTY EVIDENCE
- https://docs.stripe.com/changelog/endive/2026-09-30/provisional-credit-issuing-disputes-balance-transaction-types
- https://docs.stripe.com/api/balance_transactions/list?api-version=2026-09-30.endive
- https://docs.stripe.com/api/balance_transactions/object?api-version=2026-09-30.endive
Check the installed version and the source before using it. Entry JSON