{
  "slug": "stripe-balance-transactions-add-issuing-provisional-credit-types-b2769d7669c7",
  "title": "Stripe Balance Transactions add Issuing provisional credit types",
  "tools": [
    "stripe"
  ],
  "tags": [
    "agent"
  ],
  "introduced_at": "2026-09-30T00:00:00.000Z",
  "announced_at": "2026-09-30T00:00:00.000Z",
  "effective_at": null,
  "date_basis": "source-publication",
  "status": "unknown",
  "how": {
    "incantation": "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`.",
    "examples": [
      "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\""
    ],
    "gotchas": [
      "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."
    ]
  },
  "why_it_matters": "Update an integration that filters or processes Stripe Balance Transactions by type to handle provisional credits for Issuing disputes.",
  "sources": [
    "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"
  ],
  "rank": 0.94034,
  "judge": {
    "publish": true,
    "judge_model": "codex-cli/gpt-6-luna+typesafe/jev-1.13.0",
    "prompt_version": "extract-v7+enrich-v2+judge-v2x3+jev-publish-v1"
  },
  "review_state": "approved",
  "provenance": {
    "run_id": "wave1b-tools-20261017",
    "verdict_id": "wave1b-tools-20261017:wave1b-tools-20261017-5430a4154ab72759-0:gate",
    "evidence_hash": "4576e5e664d13a3c32d9be95ee821c56ba7792c26c09d7567083294a0ee1132e"
  },
  "review": {
    "draft_hash": "cf0b34eb2cdbd4b801e2854a81d1803b48791c66f8a9d8272847b4b33c0997ef",
    "reviewer": "publication-gate",
    "reviewed_at": "2026-10-07T00:00:00.000Z",
    "decision": "wave1b-tools-20261017:gate",
    "reason": "3 of 3 judge runs approved with p_yes >= 0.9 (mean 0.94 >= 0.9; 2 needed) and Jev gave 0.65 (>= 0.6 needed)."
  }
}