# Issuing の不審請求の申し立てに対する暫定クレジット用の取引残高タイプを追加

## 新機能

[Issuing の不審請求の申し立てに対する暫定クレジット](https://docs.stripe.com/issuing/purchases/disputes/provisional-credits.md)に関連する資金移動を表すため、[取引残高](https://docs.stripe.com/api/balance_transactions/object.md?api-version=2026-09-30.endive)の [type](https://docs.stripe.com/api/balance_transactions/object.md?api-version=2026-09-30.endive#balance_transaction_object-type) プロパティに 2 つの値を追加します。

- `issuing_dispute_provisional_credit` は、不審請求の申し立てが提出されたときに、一時的なクレジットが Issuing 残高に付与されたことを表します。
- `issuing_dispute_provisional_credit_reversal` は、不審請求の申し立ての解決時に、その暫定クレジットの差戻しが行われたことを表します。

両方の値は、[Balance Transactions を一覧表示](https://docs.stripe.com/api/balance_transactions/list.md?api-version=2026-09-30.endive#balance_transaction_list-type)するときのフィルターとして利用できます。残高レポートで区別できるように、各タイプには対応する [reporting_category](https://docs.stripe.com/api/balance_transactions/object.md?api-version=2026-09-30.endive#balance_transaction_object-reporting_category) が設定されています。既存の `issuing_dispute` タイプは引き続き、反証成功となった不審請求の申し立てに対する最終的なクレジットを表します。

## 影響

実装で Balance Transaction を `type` で絞り込んだり、処理したりしている場合、API レスポンスに `issuing_dispute_provisional_credit` および `issuing_dispute_provisional_credit_reversal` の値が含まれる場合があります。これらの値は、SDK の型定義や OpenAPI 仕様にも記載されています。実装を対応させるには、以下を実行します。

- `type` に依存するコードを更新し、追加された 2 つの値を処理するようにします。コードで認識できないタイプに対してエラーが発生する場合は、特にこの対応が重要です。
- 必要に応じて照合ワークフローを調整し、これらの新しいタイプを使用して、暫定クレジットの資金移動と不審請求の申し立ての最終的なクレジットを区別できるようにします。
- レポートカテゴリーに依存している[残高レポート](https://docs.stripe.com/reports/balance.md)を確認します。各タイプにはそれぞれに対応する固有の `reporting_category` が存在するためです。

## 変更点

#### REST API

| Values | Change | Enum |
| --- | --- | --- |
| `issuing_dispute_provisional_credit`, `issuing_dispute_provisional_credit_reversal` | Added | [BalanceTransaction.type](/api/balance_transactions/object?api-version=2026-09-30.endive#balance_transaction_object-type) |

#### Ruby

この変更は Ruby SDK には影響しません。

#### Python

| Values | Change | Enum |
| --- | --- | --- |
| `issuing_dispute_provisional_credit`, `issuing_dispute_provisional_credit_reversal` | Added | [BalanceTransaction.type](/api/balance_transactions/object?api-version=2026-09-30.endive#balance_transaction_object-type) |

#### PHP

| Values | Change | Enum |
| --- | --- | --- |
| `issuing_dispute_provisional_credit`, `issuing_dispute_provisional_credit_reversal` | Added | [BalanceTransaction.type](/api/balance_transactions/object?api-version=2026-09-30.endive#balance_transaction_object-type) |

#### Java

この変更は Java SDK には影響しません。

#### Node.js

| Values | Change | Enum |
| --- | --- | --- |
| `issuing_dispute_provisional_credit`, `issuing_dispute_provisional_credit_reversal` | Added | [BalanceTransaction.type](/api/balance_transactions/object?api-version=2026-09-30.endive#balance_transaction_object-type) |

#### Go

| Values | Change | Enum |
| --- | --- | --- |
| `issuing_dispute_provisional_credit`, `issuing_dispute_provisional_credit_reversal` | Added | [BalanceTransaction.Type](/api/balance_transactions/object?api-version=2026-09-30.endive#balance_transaction_object-Type) |

#### .NET

この変更は .NET SDK には影響しません。

## アップグレード

#### REST API

1. ワークベンチで[現在の API バージョンを確認](https://docs.stripe.com/workbench/guides.md#view-api-versions)してください。
2. SDK を使用している場合は、この API バージョンに対応する SDK バージョンにアップグレードします。
   - SDK を使用しない場合は、[API リクエスト](https://docs.stripe.com/api-versions.md#how-versions-are-specified-in-requests)を更新して `Stripe-Version: 2026-09-30.endive` を含めてください
3. [Webhook エンドポイント](https://docs.stripe.com/webhooks/versioning.md)に使用する API バージョンをアップグレードします。
4. 新しいバージョンに対して、[実装内容をテスト](https://docs.stripe.com/testing.md)します。
5. Connect を使用する場合は、[Connect の実装内容をテスト](https://docs.stripe.com/connect/testing.md)します。

[Stripe API のアップグレード](https://docs.stripe.com/upgrades.md)について、詳細をご確認ください。

#### Ruby

1. Workbench で[現在の API バージョンを表示します](https://docs.stripe.com/upgrades.md#view-your-api-version-and-the-latest-available-upgrade-in-workbench)。
2. Ruby SDK を 最新バージョンにアップグレードします。
3. [Webhook エンドポイント](https://docs.stripe.com/webhooks/versioning.md)に使用する API バージョンをアップグレードします。
4. 新しいバージョンに対して、[実装内容をテスト](https://docs.stripe.com/testing.md)します。
5. Connect を使用する場合は、[Connect の実装内容をテスト](https://docs.stripe.com/connect/testing.md)します。
6. Workbench で[アップグレードを実行](https://docs.stripe.com/upgrades.md#perform-the-upgrade)します。[バージョンをロールバック](https://docs.stripe.com/upgrades.md#roll-back-your-api-version)できるのは 72 時間以内です。

[Stripe API のアップグレード](https://docs.stripe.com/upgrades.md)について、詳細をご確認ください。

#### Python

1. Workbench で[現在の API バージョンを表示します](https://docs.stripe.com/upgrades.md#view-your-api-version-and-the-latest-available-upgrade-in-workbench)。
2. Python SDK を 最新バージョンにアップグレードします。
3. [Webhook エンドポイント](https://docs.stripe.com/webhooks/versioning.md)に使用する API バージョンをアップグレードします。
4. 新しいバージョンに対して、[実装内容をテスト](https://docs.stripe.com/testing.md)します。
5. Connect を使用する場合は、[Connect の実装内容をテスト](https://docs.stripe.com/connect/testing.md)します。
6. Workbench で[アップグレードを実行](https://docs.stripe.com/upgrades.md#perform-the-upgrade)します。[バージョンをロールバック](https://docs.stripe.com/upgrades.md#roll-back-your-api-version)できるのは 72 時間以内です。

[Stripe API のアップグレード](https://docs.stripe.com/upgrades.md)について、詳細をご確認ください。

#### PHP

1. Workbench で[現在の API バージョンを表示します](https://docs.stripe.com/upgrades.md#view-your-api-version-and-the-latest-available-upgrade-in-workbench)。
2. PHP SDK を 最新バージョンにアップグレードします。
3. [Webhook エンドポイント](https://docs.stripe.com/webhooks/versioning.md)に使用する API バージョンをアップグレードします。
4. 新しいバージョンに対して、[実装内容をテスト](https://docs.stripe.com/testing.md)します。
5. Connect を使用する場合は、[Connect の実装内容をテスト](https://docs.stripe.com/connect/testing.md)します。
6. Workbench で[アップグレードを実行](https://docs.stripe.com/upgrades.md#perform-the-upgrade)します。[バージョンをロールバック](https://docs.stripe.com/upgrades.md#roll-back-your-api-version)できるのは 72 時間以内です。

[Stripe API のアップグレード](https://docs.stripe.com/upgrades.md)について、詳細をご確認ください。

#### Java

1. Workbench で[現在の API バージョンを表示します](https://docs.stripe.com/upgrades.md#view-your-api-version-and-the-latest-available-upgrade-in-workbench)。
2. Java SDK を 最新バージョンにアップグレードします。
3. [Webhook エンドポイント](https://docs.stripe.com/webhooks/versioning.md)に使用する API バージョンをアップグレードします。
4. 新しいバージョンに対して、[実装内容をテスト](https://docs.stripe.com/testing.md)します。
5. Connect を使用する場合は、[Connect の実装内容をテスト](https://docs.stripe.com/connect/testing.md)します。
6. Workbench で[アップグレードを実行](https://docs.stripe.com/upgrades.md#perform-the-upgrade)します。[バージョンをロールバック](https://docs.stripe.com/upgrades.md#roll-back-your-api-version)できるのは 72 時間以内です。

[Stripe API のアップグレード](https://docs.stripe.com/upgrades.md)について、詳細をご確認ください。

#### Node.js

1. Workbench で[現在の API バージョンを表示します](https://docs.stripe.com/upgrades.md#view-your-api-version-and-the-latest-available-upgrade-in-workbench)。
2. Node SDK を 最新バージョンにアップグレードします。
3. [Webhook エンドポイント](https://docs.stripe.com/webhooks/versioning.md)に使用する API バージョンをアップグレードします。
4. 新しいバージョンに対して、[実装内容をテスト](https://docs.stripe.com/testing.md)します。
5. Connect を使用する場合は、[Connect の実装内容をテスト](https://docs.stripe.com/connect/testing.md)します。
6. Workbench で[アップグレードを実行](https://docs.stripe.com/upgrades.md#perform-the-upgrade)します。[バージョンをロールバック](https://docs.stripe.com/upgrades.md#roll-back-your-api-version)できるのは 72 時間以内です。

[Stripe API のアップグレード](https://docs.stripe.com/upgrades.md)について、詳細をご確認ください。

#### Go

1. Workbench で[現在の API バージョンを表示します](https://docs.stripe.com/upgrades.md#view-your-api-version-and-the-latest-available-upgrade-in-workbench)。
2. Go SDK を 最新バージョンにアップグレードします。
3. [Webhook エンドポイント](https://docs.stripe.com/webhooks/versioning.md)に使用する API バージョンをアップグレードします。
4. 新しいバージョンに対して、[実装内容をテスト](https://docs.stripe.com/testing.md)します。
5. Connect を使用する場合は、[Connect の実装内容をテスト](https://docs.stripe.com/connect/testing.md)します。
6. Workbench で[アップグレードを実行](https://docs.stripe.com/upgrades.md#perform-the-upgrade)します。[バージョンをロールバック](https://docs.stripe.com/upgrades.md#roll-back-your-api-version)できるのは 72 時間以内です。

[Stripe API のアップグレード](https://docs.stripe.com/upgrades.md)について、詳細をご確認ください。

#### .NET

1. Workbench で[現在の API バージョンを表示します](https://docs.stripe.com/upgrades.md#view-your-api-version-and-the-latest-available-upgrade-in-workbench)。
2. .NET SDK を 最新バージョンにアップグレードします。
3. [Webhook エンドポイント](https://docs.stripe.com/webhooks/versioning.md)に使用する API バージョンをアップグレードします。
4. 新しいバージョンに対して、[実装内容をテスト](https://docs.stripe.com/testing.md)します。
5. Connect を使用する場合は、[Connect の実装内容をテスト](https://docs.stripe.com/connect/testing.md)します。
6. Workbench で[アップグレードを実行](https://docs.stripe.com/upgrades.md#perform-the-upgrade)します。[バージョンをロールバック](https://docs.stripe.com/upgrades.md#roll-back-your-api-version)できるのは 72 時間以内です。

[Stripe API のアップグレード](https://docs.stripe.com/upgrades.md)について、詳細をご確認ください。