# 一部キャプチャーおよび支払いキャンセルフローの Refund オブジェクトを削除

## 新規情報

次のフローでは、`Refund` オブジェクトの作成および支払いへの関連付けが行われなくなります。

- 一部キャプチャー
- 支払いのキャンセル (手動および自動)

## 対応処理が必要な変更である理由

この変更により、次のシナリオで実装が中断される可能性があります。

- 実装が、部分的なキャプチャーまたは支払いのキャンセルが返金オブジェクトを作成すると想定される場合。
- 実装が、部分的なキャプチャーが残高取引を 2 つ作成すると想定されている場合。

実装に影響が出る可能性のある詳細については、以下の内訳を参照してください。

## 影響力

この変更は、キャプチャーの差戻しや支払いのキャンセルを `Refund` オブジェクトまたは関連フィールドに依存している場合、システムに影響します。`Refund` オブジェクトを削除すると、次のフィールドまたはオブジェクトに影響します。

### Refund オブジェクト

- キャンセルまたはキャプチャーの差戻しを表す `Refund` オブジェクトは作成されなくなります。
- 支払いインテントまたは支払いに関連するすべての返金を取得するために呼び出しても、返されません。
- Webhook イベントには表示されません。
- API レスポンスの `Charge` オブジェクトには表示されません。
- ダッシュボードには表示されません。

### PaymentIntent オブジェクト

- `expired` という新しい `cancellation_reason` の値が導入されます。この新しい値は、オーソリの有効期限切れによりキャンセルされた支払いを表します。これは、以前使用されていた値 `automatic` に置き換わります。

### Charge オブジェクト

- `amount_captured` は、支払いキャンセルフローで `nil` ではなく 0 になります。
- `amount_refunded` は、これらのアクションによって更新されなくなります。
- `refunded` は、支払いキャンセルフローで `true` ではなくなります。

### 取引残高

- 一部キャプチャーでは 1 つの残高取引のみ表示されます。差戻された金額と手数料を記載した残高取引は表示されません。
- キャプチャー額を記載した残高取引には、関連する支払いに対して承認された金額ではなく、キャプチャーされた金額が表示されます。

### Webhook

- `charge.refunded` イベントと `charge.refund.updated` イベントは送信しません。
- Stripe はその後も各フローの `charge.expired`、`charge.captured`、`payment_intent.canceled` イベントを送信します。

### Radar の支払いレビュー

- 該当する場合、支払いのキャンセル時に、`refunded` ではなく `canceled` の理由で Radar の支払いレビューが終了します。

## 変更点

#### REST API

#### Ruby

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

#### Python

#### PHP

#### Java

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

#### Node.js

#### Go

#### .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: 2025-03-31.basil` を含めるように [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 を [v15.0.0](https://github.com/stripe/stripe-ruby/releases/tag/v15.0.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 を [v12.0.0](https://github.com/stripe/stripe-python/releases/tag/v12.0.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 を [v17.0.0](https://github.com/stripe/stripe-php/releases/tag/v17.0.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 を [v29.0.0](https://github.com/stripe/stripe-java/releases/tag/v29.0.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 を [v18.0.0](https://github.com/stripe/stripe-node/releases/tag/v18.0.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 を [v82.0.0](https://github.com/stripe/stripe-go/releases/tag/v82.0.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 を [v48.0.0](https://github.com/stripe/stripe-dotnet/releases/tag/v48.0.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)について、詳細をご確認ください。

## 関連する変更点

- [Vault and Forward API を更新し、アップストリームリクエストのタイムアウトに 402 ステータスコードを返す](https://docs.stripe.com/changelog/basil/2025-03-31/vault-forward-api-returns-402.md)
- [Interac カードの手動キャプチャーのメソッドを削除しました](https://docs.stripe.com/changelog/basil/2025-03-31/deprecate-interac-present-manual-capture-method.md)
- [Payment Methods でオブジェクトを最初に作成すると Naver Pay のフィールドが変更できなくなる仕様になります](https://docs.stripe.com/changelog/basil/2025-03-31/naver-pay-payment-method.md)
- [オンライン請求書ページで Klarna のサポートを追加](https://docs.stripe.com/changelog/basil/2025-03-31/klarna-send-invoice.md)
- [オンライン請求書ページで 1 回限りの決済用に保存された決済手段を設定する機能を追加](https://docs.stripe.com/changelog/basil/2025-03-31/hosted-payment-method-save.md)
- [Naver Pay の決済手段の保存と再利用のサポートを追加](https://docs.stripe.com/changelog/basil/2025-03-31/naver-pay-recurring.md)
- [Billie の現地の決済手段に対するサポートを追加](https://docs.stripe.com/changelog/basil/2025-03-31/add-billie.md)
- [Satispay のローカル決済手段のサポートを追加](https://docs.stripe.com/changelog/basil/2025-03-31/satispay-lpm.md)
- [確認時まで WeChat Pay の client パラメーターを任意に](https://docs.stripe.com/changelog/basil/2025-03-31/lient-param-optional-wechatpay-before-confirmation.md)
- [ニュージーランドの BECS ダイレクトデビットの現地決済手段のサポートを追加](https://docs.stripe.com/changelog/basil/2025-03-31/nz-bank-account.md)