Issuing オーソリに不正利用リスク評価を追加しました

新機能

高度な不正利用防止ツールを使用する場合、Issuing Authorizationには GA 版の risk_assessment.fraud_risk プロパティが含まれるようになりました。これにより、オーソリの不正利用の可能性に関する Stripe の評価が提供されます。

risk_assessment.fraud_risk プロパティには以下が含まれます。

level: 不正利用のリスクレベルを示す文字列（elevated、highest、low、normal、not_assessed、またはunknown）。
score: 不正利用リスクスコアの数値を表すフロート値。

この評価は、Stripe の不正利用検出アルゴリズムに基づき、オーソリリクエストを承認するか拒否するかを判断する際の参考情報を提供します。

オーソリオブジェクトから直接不正利用リスク情報にアクセスして、不正利用防止戦略を強化できます。データはオーソリを取得するとすぐに利用可能になり、カスタムオーソリロジックやモニタリングワークフローの実装に使用できます。

現在、高度な不正利用防止ツールのプレビュー版を使用している場合、この GA リリースでは以下の点が異なります。

発生し得るリスクレベルを拡大しました。
不正利用リスクスコアは整数ではなく浮動小数点数です。
2 つのフィールドの名前が変更されました。
- risk_level が level になりました
- fraud_score が score になりました。

パラメーター	変更する	リソースまたはエンドポイント
fraud_risk	追加済み	Issuing.Authorization.testHelpers#create.risk_assessment

Workbench で現在の API バージョンを表示します。
SDK を使用している場合は、この API バージョンに対応する SDK バージョンにアップグレードします。
- SDK を使用していない場合は、Stripe-Version: 2025-11-17.clover を含めるように API リクエストを更新してください。
Webhook エンドポイントに使用する API バージョンをアップグレードします。
新しいバージョンに対して、実装内容をテストします。
Connect を使用する場合は、Connect の実装内容をテストします。
Workbench でアップグレードを実行します。バージョンをロールバックできるのは 72 時間以内です。

Stripe API のアップグレードについて、詳細をご確認ください。