トランザクションモニタリングクイックスタート - 10分で導入

Diditのトランザクションモニタリングを10分以内に立ち上げます。テスト取引を送信してスコアを確認し、プリセットルールを有効にして再送信するとルールが発火し、Webhookが届くことを確認します。

前提条件

トランザクションモニタリングを有効にしたDiditのアプリケーション(設定 → 取引モニタリング → 有効にする)。
APIキー。
インターネットから到達できるWebhookエンドポイント。

手順

ベースラインの取引を送信する

curl -X POST https://verification.didit.me/v3/transactions/ \
  -H "x-api-key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "transaction_id": "baseline-0001",
    "transaction_category": "finance",
    "transaction_details": {
      "direction": "outbound",
      "amount": "500.00",
      "currency": "EUR"
    },
    "subject": { "entity_type": "person", "vendor_data": "user-42", "full_name": "Jane Doe" },
    "counterparty": { "entity_type": "company", "full_name": "Acme Supplier" }
  }'

レスポンスには次の内容が含まれます。

status — ルールが発火しなかった場合はAPPROVED、発火した場合はIN_REVIEW / DECLINED。
score — 0〜100+の整数。
rule_runs — この取引を評価したすべてのルールの配列。

プリセットルールを有効にする

ビジネスコンソールで取引 → ルール → ライブラリを開きます。プリセットを選択します。たとえば**Structuring (outbound)**は、同じユーザーが30日以内に€10,000未満の送金を20+件行うと発火します。有効にして保存します。

ルールが発火する取引を送信する

同じユーザーについて、それぞれ€10,000未満の取引を20件、すばやく送信します。

for i in $(seq 1 20); do
  curl -X POST https://verification.didit.me/v3/transactions/ \
    -H "x-api-key: YOUR_API_KEY" \
    -H "Content-Type: application/json" \
    -d "{
      \"transaction_id\": \"struct-$i\",
      \"transaction_category\": \"finance\",
      \"transaction_details\": {
        \"direction\": \"outbound\",
        \"amount\": \"9500.00\",
        \"currency\": \"EUR\"
      },
      \"subject\": { \"entity_type\": \"person\", \"vendor_data\": \"user-42\", \"full_name\": \"Jane Doe\" },
      \"counterparty\": { \"entity_type\": \"company\", \"full_name\": \"Shell Co $i\" }
    }"
done

20回目の送信までに、Structuringルールが発火します。取引はstatus: IN_REVIEWを返し、scoreにはルールのscore_deltaが反映されます。

取引のWebhookを購読する

curl -X POST https://verification.didit.me/v3/webhook/destinations/ \
  -H "x-api-key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "label": "TM events",
    "url": "https://yourapp.com/webhooks/didit-tm",
    "subscribed_events": ["transaction.created", "transaction.status.updated"]
  }'

レスポンスにはsecret_shared_keyが含まれます。すぐに.envのDIDIT_WEBHOOK_SECRETとして保存してください。

DIDIT_WEBHOOK_SECRET=whsec_...   # signing secret returned from webhook registration

その後、受信するすべてのWebhookについて、信頼する前にX-Signature-V2のHMACを検証してください(正規化した本文に対してHMAC-SHA256を再計算し、定数時間で比較し、古いタイムスタンプは拒否します)。ペイロードと検証コードの全体は、TMのWebhookをご覧ください。以降のすべての取引が、リアルタイムでエンドポイントに送信されます。

コンソールで確認する

コンソールで取引を開きます。

一覧ビュー: 最近の取引、フィルター、一括操作。
取引の詳細: ルールの実行結果、IPの付加情報、関係者の詳細、ネットワークグラフ(暗号資産の場合)、紐付けられたアラートとケース。

APIで取引を取得する

curl https://verification.didit.me/v3/transactions/{transaction_id}/ \
  -H "x-api-key: YOUR_API_KEY"

スコア、一致したルール、関係者の付加情報、AMLスクリーニングなどを含む完全なレスポンススキーマが返されます。

設定した内容

リアルタイムのスコアリング — すべての取引が、有効なすべてのルールを通して評価されます。
AMLスクリーニング — 取引相手は、制裁リストやネガティブメディアに対して自動でスクリーニングされます。
IPの付加情報 — すべての取引に、IPの国、ASN、VPN/Torのフラグが付与されます。
Webhook — すべての取引をリアルタイムで通知します。
監査証跡 — ルールの実行結果、アラート、ステータスの遷移は、すべてコンソールで検索できます。

次のステップ

連携ガイド

アーキテクチャとパターンの全体像。

ルールの詳細

ルールの仕組み、条件、集計、アクション。

リスクスコアリング

スコアがどのようにステータスにまとめられるか。

取引のペイロード

取引送信スキーマの全体。

ステータス

取引、アラート、ケースの状態。

ケース

調査して解決します。

​前提条件

​手順

​設定した内容

​次のステップ