APPROVED、IN_REVIEW、DECLINED) が決まり、アラートの作成、ケースの起票、ユーザーによる是正対応の要求を行うかどうかも判定されます。
計算式
- 基本スコア: 0。
- 一致した各ルールが、設定された
score_delta(通常は25〜35)を加算します。 - 一致するルールがない取引のスコアは0です。
しきい値とステータス
スコアのしきい値は、アプリケーションごとに取引 → 設定で設定します。
ステータスの割り当て:
action: change_status → DECLINEDを持つルールは、スコアに関係なく取引を却下します。
ルールの寄与と計算例
1件の取引で次のルールが発動したとします。
合計スコア = 30 + 35 + 35 = 100。
レビューしきい値が60、却下しきい値が85の場合、この取引は
DECLINEDになります。
デフォルトのしきい値 (レビュー75、却下500) の場合はIN_REVIEWになります。デフォルトではスコアによる却下が行われないためです。
アクションによる上書き
ルールは、スコアのしきい値を適用せずにステータスを直接設定することもできます。
1つのルールに複数のアクションを設定できます。たとえば
add_score(35) + add_tags(["structuring"]) + add_note("Auto-tagged by structuring preset")のような組み合わせです。
スコアが固定ルールより優れている理由
単純なしきい値 (例:「$100kを超えるすべての取引を却下する」) では、正当な高額取引と実際のリスクの両方が引っかかります。中程度のscore_deltaを持つ複数のルールと、レビュー・却下のしきい値を組み合わせることで、次のメリットが得られます。
- 多層的なスコアリング: 単一のルールだけでは却下されず、複数のシグナルが一致する必要があります。
- 感度の調整: ルールの定義を変更せずに、しきい値を上げ下げできます。
- 深刻度に応じた振り分け: スコア65の取引はレビューに回り (確認する価値あり)、スコア90の取引は却下されます (深刻)。
しきい値の設定
取引 → 設定から設定します。- レビューしきい値: レビューキューがあふれている場合は上げ、より多くのエッジケースを捕捉したい場合は下げます。
- 却下しきい値: 誤検知による却下を減らしたい場合は上げ、積極的なブロックを優先したい場合は下げます。最大値 (
500) に設定すると、高スコアの取引は自動却下されずにレビューに回されます。
ルールのテストモード
ルールはTESTモードで実行できます。
- ルールは取引に対して評価されますが、スコアやステータスには影響しません。
TransactionRuleRunレコードがis_test = trueで作成されます。- 本番環境で却下されるリスクなしに、ルールの選択性を検証できます。
ACTIVEに切り替えてください。
重大度とレガシーフィールド
TransactionとTransactionAlertのseverityフィールドはnull許容のレガシーフィールドです。新しいルール評価ではこのフィールドは設定されません。主要なリスクシグナルとしてはscoreを使用してください。
スコアの確認
API経由
すべての取引のレスポンスには、scoreと、一致したルールごとに1エントリを持つrule_runs[]配列が含まれます (すべてのフィールドについてはレスポンススキーマを参照してください)。
コンソール
取引の詳細ページでは、Scoreタブに、一致した各ルールの寄与の内訳と最終ステータスへのマッピングが表示されます。スコアのバッジにカーソルを合わせると、評価時点で使用されたしきい値が表示されます。次のステップ
ルール
ルールの構成と評価。
アラート
ルールが発動したときの動作。
設定
しきい値を設定します。