# 取引残高のリザーブ状況の把握と、リスク準備金による残高変動の照合が可能になりました

## 新機能

リザーブアクティビティーを追跡するために、[Balance Transaction](https://docs.stripe.com/api/balance_transactions/object.md?api-version=2026-01-28.clover) [type](https://docs.stripe.com/api/balance_transactions/object.md?api-version=2026-01-28.clover#balance_transaction_object-type) に次の 2 つの新しい値を追加します。

- `reserve_hold`: 資金がリザーブに留保されるタイミングを記録
- `reserve_release`: リザーブされた資金がリリースされ、利用可能な残高に戻されるタイミングを記録

[balance_type](https://docs.stripe.com/api/balance_transactions/object.md?api-version=2026-01-28.clover#balance_transaction_object-balance_type) プロパティに新しい `risk_reserved` 値を追加して、リスクリザーブ残高に影響する取引を示します。

## 影響

`reserve_hold` タイプと `reserve_release` タイプの[取引残高をフィルタリング](https://docs.stripe.com/api/balance_transactions/list.md?api-version=2026-01-28.clover#list_balance_transactions-type)して、リザーブアクティビティーを把握できるようになりました。`risk_reserved` の [balance type](https://docs.stripe.com/api/balance_transactions/object.md?api-version=2026-01-28.clover#balance_transaction_object-balance_type) を使用して、リスクリザーブ残高の変更を照合します。

## 変更点

#### REST API

| Values                            | Change | Enums                                                                                                                        |
| --------------------------------- | ------ | ---------------------------------------------------------------------------------------------------------------------------- |
| `risk_reserved`                   | Added  | [BalanceTransaction](/api/balance_transactions/object?api-version=2026-01-28.clover#balance_transaction_object-balance_type) |
| `reserve_hold`, `reserve_release` | Added  | [BalanceTransaction](/api/balance_transactions/object?api-version=2026-01-28.clover#balance_transaction_object-type)         |

#### Ruby

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

#### Python

| Values                            | Change | Enums                                                                                                                        |
| --------------------------------- | ------ | ---------------------------------------------------------------------------------------------------------------------------- |
| `risk_reserved`                   | Added  | [BalanceTransaction](/api/balance_transactions/object?api-version=2026-01-28.clover#balance_transaction_object-balance_type) |
| `reserve_hold`, `reserve_release` | Added  | [BalanceTransaction](/api/balance_transactions/object?api-version=2026-01-28.clover#balance_transaction_object-type)         |

#### PHP

| Values                            | Change | Enums                                                                                                                        |
| --------------------------------- | ------ | ---------------------------------------------------------------------------------------------------------------------------- |
| `risk_reserved`                   | Added  | [BalanceTransaction](/api/balance_transactions/object?api-version=2026-01-28.clover#balance_transaction_object-balance_type) |
| `reserve_hold`, `reserve_release` | Added  | [BalanceTransaction](/api/balance_transactions/object?api-version=2026-01-28.clover#balance_transaction_object-type)         |

#### Java

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

#### Node.js

| Values                            | Change | Enums                                                                                                                        |
| --------------------------------- | ------ | ---------------------------------------------------------------------------------------------------------------------------- |
| `risk_reserved`                   | Added  | [BalanceTransaction](/api/balance_transactions/object?api-version=2026-01-28.clover#balance_transaction_object-balance_type) |
| `reserve_hold`, `reserve_release` | Added  | [BalanceTransaction](/api/balance_transactions/object?api-version=2026-01-28.clover#balance_transaction_object-type)         |

#### Go

| Values                            | Change | Enums                                                                                                                       |
| --------------------------------- | ------ | --------------------------------------------------------------------------------------------------------------------------- |
| `risk_reserved`                   | Added  | [BalanceTransaction](/api/balance_transactions/object?api-version=2026-01-28.clover#balance_transaction_object-BalanceType) |
| `reserve_hold`, `reserve_release` | Added  | [BalanceTransaction](/api/balance_transactions/object?api-version=2026-01-28.clover#balance_transaction_object-Type)        |

#### .NET

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

## アップグレード

#### REST API

1. Workbench で[現在の API バージョンを表示します](https://docs.stripe.com/upgrades.md#view-your-api-version-and-the-latest-available-upgrade-in-workbench)。
1. SDK を使用している場合は、この API バージョンに対応する SDK バージョンにアップグレードします。
   - SDK を使用していない場合は、`Stripe-Version: 2026-01-28.clover` を含めるように [API リクエスト](https://docs.stripe.com/api/versioning.md)を更新してください。
1. [Webhook エンドポイント](https://docs.stripe.com/webhooks/versioning.md)に使用する API バージョンをアップグレードします。
1. 新しいバージョンに対して、[実装内容をテスト](https://docs.stripe.com/testing.md)します。
1. Connect を使用する場合は、[Connect の実装内容をテスト](https://docs.stripe.com/connect/testing.md)します。
1. 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)について、詳細をご確認ください。

#### Ruby

1. Workbench で[現在の API バージョンを表示します](https://docs.stripe.com/upgrades.md#view-your-api-version-and-the-latest-available-upgrade-in-workbench)。
1. Ruby SDK を [v18.2.0](https://github.com/stripe/stripe-ruby/releases/tag/v18.2.0)にアップグレードします。
1. [Webhook エンドポイント](https://docs.stripe.com/webhooks/versioning.md)に使用する API バージョンをアップグレードします。
1. 新しいバージョンに対して、[実装内容をテスト](https://docs.stripe.com/testing.md)します。
1. Connect を使用する場合は、[Connect の実装内容をテスト](https://docs.stripe.com/connect/testing.md)します。
1. 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)。
1. Python SDK を [v14.2.0](https://github.com/stripe/stripe-python/releases/tag/v14.2.0)にアップグレードします。
1. [Webhook エンドポイント](https://docs.stripe.com/webhooks/versioning.md)に使用する API バージョンをアップグレードします。
1. 新しいバージョンに対して、[実装内容をテスト](https://docs.stripe.com/testing.md)します。
1. Connect を使用する場合は、[Connect の実装内容をテスト](https://docs.stripe.com/connect/testing.md)します。
1. 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)。
1. PHP SDK を [v19.2.0](https://github.com/stripe/stripe-php/releases/tag/v19.2.0)にアップグレードします。
1. [Webhook エンドポイント](https://docs.stripe.com/webhooks/versioning.md)に使用する API バージョンをアップグレードします。
1. 新しいバージョンに対して、[実装内容をテスト](https://docs.stripe.com/testing.md)します。
1. Connect を使用する場合は、[Connect の実装内容をテスト](https://docs.stripe.com/connect/testing.md)します。
1. 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)。
1. Java SDK を [v31.2.0](https://github.com/stripe/stripe-java/releases/tag/v31.2.0)にアップグレードします。
1. [Webhook エンドポイント](https://docs.stripe.com/webhooks/versioning.md)に使用する API バージョンをアップグレードします。
1. 新しいバージョンに対して、[実装内容をテスト](https://docs.stripe.com/testing.md)します。
1. Connect を使用する場合は、[Connect の実装内容をテスト](https://docs.stripe.com/connect/testing.md)します。
1. 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)。
1. Node SDK を [v20.2.0](https://github.com/stripe/stripe-node/releases/tag/v20.2.0)にアップグレードします。
1. [Webhook エンドポイント](https://docs.stripe.com/webhooks/versioning.md)に使用する API バージョンをアップグレードします。
1. 新しいバージョンに対して、[実装内容をテスト](https://docs.stripe.com/testing.md)します。
1. Connect を使用する場合は、[Connect の実装内容をテスト](https://docs.stripe.com/connect/testing.md)します。
1. 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)。
1. Go SDK を [v84.2.0](https://github.com/stripe/stripe-go/releases/tag/v84.2.0)にアップグレードします。
1. [Webhook エンドポイント](https://docs.stripe.com/webhooks/versioning.md)に使用する API バージョンをアップグレードします。
1. 新しいバージョンに対して、[実装内容をテスト](https://docs.stripe.com/testing.md)します。
1. Connect を使用する場合は、[Connect の実装内容をテスト](https://docs.stripe.com/connect/testing.md)します。
1. 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)。
1. .NET SDK を [v50.2.0](https://github.com/stripe/stripe-dotnet/releases/tag/v50.2.0)にアップグレードします。
1. [Webhook エンドポイント](https://docs.stripe.com/webhooks/versioning.md)に使用する API バージョンをアップグレードします。
1. 新しいバージョンに対して、[実装内容をテスト](https://docs.stripe.com/testing.md)します。
1. Connect を使用する場合は、[Connect の実装内容をテスト](https://docs.stripe.com/connect/testing.md)します。
1. 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)について、詳細をご確認ください。

## 関連する変更

- [3D セキュアバージョン 2.3.0 および 2.3.1 のサポートを追加](https://docs.stripe.com/changelog/clover/2026-01-28/3d-secure-version-support.md)
- [決済項目の厳密な演算検証をオプトアウトする機能を追加](https://docs.stripe.com/changelog/clover/2026-01-28/loosen-arithmetic-validation-for-payment-line-items.md)
- [Adyen を iDEAL 決済の発行者として追加](https://docs.stripe.com/changelog/clover/2026-01-28/adds-adyen-as-an-issuer-for-ideal-payments.md)
- [項目レスポンスに調整可能な数量を追加](https://docs.stripe.com/changelog/clover/2026-01-28/line-items-adjustable-quantity.md)