シャドウモード
このページで
「シャドウモード」を使用すると、商人は複数の不正防止プロバイダーを並行して評価できます。これにより、トランザクションの流れを中断することなく、不正防止機能の評価や、リアルタイムデータを用いたモデルの調整を行うことができます。
特に、不正検出のパフォーマンスを比較したり、実際のデータを使用してモデルを調整したりする場合に便利です。ただし、実際の承認や顧客体験に影響を与えることなく利用できます。
仕組みは次のとおりです。#
シャドウモードが有効になっている場合、DEUNAは各取引を、あなたの 主要な不正防止プロバイダー と 影プロバイダー.
シャドウプロバイダーは並行して動作し、メインプロバイダーと同じトランザクションデータを受信します。ただし、その評価は 影響しません 購入決定または決済フロー—これは、比較および監視の目的でのみ実行されます。
トランザクションが完了すると、DEUNAは影プロバイダーからの評価結果をAPIレスポンスに含めます。結果は以下に返されます。 fraud_shadowmode オブジェクトで、主要な不正検出応答の構造を反映しています。
以下の方法で、シャドウモードの結果にアクセスできます。
- GET /order — 影プロバイダーの応答は、
fraud_shadowmodefield. - Purchase APIからの応答 — 同様に含みます
fraud_shadowmodeobject.
これにより、両方のプロバイダーの結果を安全に比較し、リスク評価における差異を特定し、プロバイダーの切り替えや不正対策戦略の更新に関するデータに基づいた意思決定を行うことができます。
設定#
Shadow Modeを有効にするには、詐欺戦略構成内でshadowプロバイダーを定義する必要があります。 shadowプロバイダーは、メインのトランザクションと同じリクエストを受け取りますが、評価は無効になり、支払いを確認または承認しません。
もし、選択されたプロバイダーが デバイスフィンガープリントを必要とする場合、DEUNAは、メインのAPI呼び出しで送信されたフィンガープリント値を自動的に再利用します。 ただし 1 つのフィンガープリント 1 つのトランザクションあたり、メインプロバイダーとシャドウプロバイダー間で同じ値が共有されます。
これにより、異なるフィンガープリントによる評価の一貫性を確保し、スコアリングの不一致を防ぎます。
1. Shadow モードを有効化
支払い戦略における Shadow モードの設定の最初のステップは、商取引レベルで有効化することです。
- DEUNA 管理者ポータルの Commerce セクションに移動します。
- 「支払い設定」タブを開きます。
- 「不正検知設定」セクションで、以下のスイッチを有効にします。
Shadow モードでの不正検知プロバイダーの有効化 Shadow モードは、支払いプロセッサによって取引の処理を停止することなく、同期的な不正検知評価を可能にします。
この設定を有効にすると、Shadow モードは支払い戦略内で設定できます。
2. Shadow モードの設定
支払い戦略に対して Shadow モードを設定するには、Shadow モードで実行する不正検知プロバイダーを 1 つ以上選択します。
決済方法
各決済フローのデフォルト処理とルールを設定します。
デフォルト処理
各決済フローのデフォルト処理とルールを設定します。
| ルール | ルーティング | ステータス | アクション |
|---|---|---|---|
| デフォルト処理 | Adyen → Worldpay | アクティブ |
特定のルール
各決済フローのデフォルト処理とルールを設定します。
| 優先度 | ルール | 条件 | ルーティング | ステータス |
|---|---|---|---|---|
| 1 | 高額注文 | 100ドル以上の金額 | Adyen → Worldpay | アクティブ |
- 「支払い戦略」セクションに移動します。
- 新しい戦略を作成するか、既存の戦略を編集します。
- 「不正検知設定」セクションに移動します。
- 「Shadow モード」領域を見つけて、テストしたいプロバイダーを選択します。
以下のフローに対して異なるプロバイダーを割り当てることができます。
- 事前承認フロー
- 事後承認フロー
複数のフローに対して、1 つのプロバイダーを設定できます。
3. Shadow モードの結果の確認
Shadow モードが有効になり、取引が処理された後、結果は注文の詳細ページまたは API レスポンスで確認できます。
3.1 注文の詳細ページでの結果の確認:
- 注文の詳細ページに移動します。
- 「セキュリティ」セクションにスクロールします。
- 「不正検知プロバイダー (Shadow モード)」というサブセクションが表示されます。
- 各サンドボックスプロバイダーについて、以下の情報が表示されます。
- プロバイダ名
- リスクスコア
- リスクレベル（例：低、中、高）
- プロセッサの応答と関連する詳細
Shadow モードの結果は、 取引の可視性 セクション（注文の詳細ページ）からも確認できます。
シャドウプロバイダーへの送信されたリクエストとレスポンスを検査できるため、主要プロバイダーとの動作を比較できます。
3.2 APIレスポンスにおけるシャドウモードの結果の表示
レスポンスには以下のが含まれます。 fraud_shadowmode アンチフロールプロバイダーが構成され、その結果が表示されるオブジェクト
"fraud_shadowmode": [
{
"analysis": {
"details": "approved",
"fraud_decision": "low_risk",
"processor": "RISKIFIED",
"processor_response": "approved",
"risk_level": "low",
"score": "0",
"status": "automatic_decision",
"type": ""
},
"status": "accepted"
}
]このオブジェクトには以下のパラメータがあります。
| フィールド | Type | 説明 |
|---|---|---|
fraud_shadowmode | array | シャドウモードで実行されたアンチフロード評価のリスト。 |
analysis | object | プロセッサから返される詳細なアンチフロード分析。 |
analysis.processor | string | 分析を実行したアンチフロードプロバイダー。 |
analysis.fraud_decision | string | プロセッサによる不正判断。 |
analysis.risk_level | string | トランザクションに割り当てられたリスクレベル。 |
analysis.details | string | 人間が理解できる意思決定の詳細。 |
analysis.processor_response | string | Исходный ответ, предоставленный поставщиком мошенничества. |
analysis.score | number | 取引に割り当てられたリスクスコア。これは、[戻り値] を返します。 0 アンチフロードプロバイダーから取得できない場合、一部のアンチフロード（例：Riskified）はレスポンスにスコアを返しません。 |
analysis.status | string | 判断の実行タイプ。 |
analysis.type | string | 将来の分類またはルールタイプ用の予約フィールド |
status | string | アンチフロード分析に基づいて推奨されるトランザクションの結果。 |
ステータスに関する動作
analysis.fraud_decision | analysis.risk_level | status |
|---|---|---|
low_risk | low | accepted |
high_risk | high | rejected |
medium_risk | medium | manual_review |
注記 / 制限#
- プロバイダーは、同時に複数の役割を果たすことができません。 主要 および sombra 同じ不正行為対策におけるプロバイダー。
- Shadow モードは並行して動作し、通常の条件下で決済の決定やトランザクションの遅延に影響を与えません。
- Shadow プロバイダーが応答しない場合、メインプロバイダーの評価を中断しません。
で確認できます。 取引の可視性 ダッシュボードのセクション。 両方の リクエスト および 応答 メインプロバイダーの結果との違いを理解するために、代替プロバイダーに送信されます。