# Issuing に不正利用に関するチャレンジのサポートを追加しました

## 新機能

[Issuing](https://docs.stripe.com/issuing.md)ユーザーは、[オーソリ](https://docs.stripe.com/api/issuing/authorizations/object.md?api-version=2024-11-20.acacia)用に送信された[不正利用チャレンジ](https://docs.stripe.com/issuing/controls/fraud-challenges.md)を `fraud_challenges` 配列で確認できるようになりました。これには、チャレンジのステータスと結果も含まれます。

新しい `verified_by_fraud_challenge` フィールドは、以前に完了した不正利用に関するチャレンジによって、不正リスクコントロールがオーソリに対してバイパスされた場合に表示されます。

## 影響

不正利用に関するチャレンジは、Stripe Issuing の不正リスクコントロールによって誤って拒否された取引を、カード会員が再試行できるようにする手続きです。不正利用に関するチャレンジは、ダッシュボードページの [Issuing の設定](https://dashboard.stripe.com/settings/issuing/authorizations)で有効にできます。

## 変更点

#### REST API

| Parameters | Change | Resources or endpoints |
| --- | --- | --- |
| `fraud_challenges`, `verified_by_fraud_challenge` | Added | [Issuing.Authorization](/api/issuing/authorizations/object?api-version=2024-11-20.acacia) |

#### Ruby

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

#### Python

| Parameters | Change | Resources or methods |
| --- | --- | --- |
| `fraud_challenges`, `verified_by_fraud_challenge` | Added | [stripe.issuing.Authorization](/api/issuing/authorizations/object?api-version=2024-11-20.acacia) |

#### PHP

| Parameters | Change | Resources or methods |
| --- | --- | --- |
| `fraud_challenges`, `verified_by_fraud_challenge` | Added | [Issuing.Authorization](/api/issuing/authorizations/object?api-version=2024-11-20.acacia) |

#### Java

| Parameters | Change | Resources or methods |
| --- | --- | --- |
| `fraud_challenges`, `verified_by_fraud_challenge` | Added | [Issuing.Authorization](/api/issuing/authorizations/object?api-version=2024-11-20.acacia) |

#### Node.js

| Parameters | Change | Resources or methods |
| --- | --- | --- |
| `fraud_challenges`, `verified_by_fraud_challenge` | Added | [Issuing.Authorization](/api/issuing/authorizations/object?api-version=2024-11-20.acacia) |

#### Go

| Parameters | Change | Resources or methods |
| --- | --- | --- |
| `FraudChallenges`, `VerifiedByFraudChallenge` | Added | [IssuingAuthorization](/api/issuing/authorizations/object?api-version=2024-11-20.acacia) |

#### .NET

| Parameters | Change | Resources or methods |
| --- | --- | --- |
| `FraudChallenges`, `VerifiedByFraudChallenge` | Added | [IssuingAuthorization](/api/issuing/authorizations/object?api-version=2024-11-20.acacia) |

## アップグレード

#### REST API

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

#### Ruby

1. Workbench で[現在の API バージョンを表示します](https://docs.stripe.com/upgrades.md#view-your-api-version-and-the-latest-available-upgrade-in-workbench)。
2. Ruby SDK を [v13.2.0](https://github.com/stripe/stripe-ruby/releases/tag/v13.2.0)にアップグレードします。
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 を [v11.3.0](https://github.com/stripe/stripe-python/releases/tag/v11.3.0)にアップグレードします。
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 を [v16.3.0](https://github.com/stripe/stripe-php/releases/tag/v16.3.0)にアップグレードします。
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 を [v28.1.0](https://github.com/stripe/stripe-java/releases/tag/v28.1.0)にアップグレードします。
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 を [v17.4.0](https://github.com/stripe/stripe-node/releases/tag/v17.4.0)にアップグレードします。
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 を [v81.1.0](https://github.com/stripe/stripe-go/releases/tag/v81.1.0)にアップグレードします。
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 を [v47.1.0](https://github.com/stripe/stripe-dotnet/releases/tag/v47.1.0)にアップグレードします。
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)について、詳細をご確認ください。

## 関連する変更点

- [テスト環境のオーソリで、加盟店の金額と通貨のサポートを追加](https://docs.stripe.com/changelog/acacia/2024-11-20/add-merchant-currency-and-merchant-amount-on-create-testmode-authorization-method.md)