> ## Documentation Index
> Fetch the complete documentation index at: https://docs.didit.me/llms.txt
> Use this file to discover all available pages before exploring further.

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

> Diditのトランザクションモニタリングで、最初の取引を送信し、ルールの発火を確認してWebhookを連携するまでを10分以内で完了。取引1件あたり$0.02の従量課金で契約は不要です。

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

## 前提条件

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

## 手順

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

```bash theme={null}
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` — この取引を評価したすべてのルールの配列。

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

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

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

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

```bash theme={null}
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`が反映されます。

**4. 取引のWebhookを購読する**

```bash theme={null}
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`として保存してください。

```bash theme={null}
DIDIT_WEBHOOK_SECRET=whsec_...   # signing secret returned from webhook registration
```

その後、受信するすべてのWebhookについて、信頼する前に`X-Signature-V2`のHMACを検証してください(正規化した本文に対してHMAC-SHA256を再計算し、定数時間で比較し、古いタイムスタンプは拒否します)。ペイロードと検証コードの全体は、[TMのWebhook](https://docs.didit.me/transaction-monitoring/webhooks.md)をご覧ください。

以降のすべての取引が、リアルタイムでエンドポイントに送信されます。

**5. コンソールで確認する**

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

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

**6. APIで取引を取得する**

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

スコア、一致したルール、関係者の付加情報、AMLスクリーニングなどを含む完全な[レスポンススキーマ](https://docs.didit.me/transaction-monitoring/response-schema.md)が返されます。

## 設定した内容

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

## 次のステップ

> **[連携ガイド](https://docs.didit.me/transaction-monitoring/integration-guide.md)**
>
> アーキテクチャとパターンの全体像。

> **[ルールの詳細](https://docs.didit.me/transaction-monitoring/rules.md)**
>
> ルールの仕組み、条件、集計、アクション。

> **[リスクスコアリング](https://docs.didit.me/transaction-monitoring/risk-scoring.md)**
>
> スコアがどのようにステータスにまとめられるか。

> **[取引のペイロード](https://docs.didit.me/transaction-monitoring/transactions.md)**
>
> 取引送信スキーマの全体。

> **[ステータス](https://docs.didit.me/transaction-monitoring/statuses.md)**
>
> 取引、アラート、ケースの状態。

> **[ケース](https://docs.didit.me/transaction-monitoring/cases.md)**
>
> 調査して解決します。


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.