> ## 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.

# ユーザー取引：KYT履歴とリスク

> DiditでUserエンティティの取引履歴を取得し、取引モニタリングのルールにどう反映されるかを確認できます。月1,000件まで含まれ、以降は1件あたり$0.001です。

`vendor_data`識別子を付けて送信したすべての取引は（申請者または取引相手として）、対応するUserエンティティに紐付けられます。Userプロファイルはその人物のアクティビティを継続的に記録する台帳となり、トランザクションモニタリングはこの履歴をベロシティルールや行動ルールの入力として使用します。

## ユーザーの取引を取得する

取引一覧を`vendor_data`でフィルターします。

```bash theme={null}
curl -G https://verification.didit.me/v3/transactions/ \
  -H "x-api-key: YOUR_API_KEY" \
  --data-urlencode "vendor_data=user-42" \
  --data-urlencode "page_size=50"
```

ユーザーが申請者となっているすべての取引が返されます。取引相手側の履歴は、Business Consoleでフィルターしてください(公開されている一覧エンドポイントは申請者でのみフィルターできます)。

## 取引とユーザーの紐付けの仕組み

```mermaid theme={null}
flowchart LR
    T["Transaction<br/>txn_id=tx-0001"]
    A["applicant:<br/>vendor_data=user-42"]
    C["counterparty:<br/>vendor_data=user-99"]
    U1[User: user-42]
    U2[User: user-99]
    T --> A
    T --> C
    A -.-> U1
    C -.-> U2
```

各取引には最大4つの当事者(申請者、送金人、受取人、取引相手)が含まれます。当事者に`vendor_data`が含まれている場合、Diditはその当事者を該当するUserに紐付けます。`vendor_data`のない当事者は外部スナップショットとして保存されます(エンティティへの紐付けはありません)。

当事者モデルの詳細は[取引の送信](https://docs.didit.me/ja/transaction-monitoring/transactions.md)を参照してください。

## 集計されたリスクシグナル

取引は、次のユーザー単位のシグナルの算出に使われます。

| シグナル | 使用先 |
| - | - |
| 受信/送信の合計取引額 | ベロシティルール、しきい値判定 |
| 一定期間内の取引件数 | ベロシティルール |
| 一意の取引相手の数 | 行動ルール |
| 高リスク法域との関与 | 地域ルール |
| 制裁対象の取引相手との関わり | スクリーニングルール |
| 支払い方法の多様性 | 不正検知ルール |

これらのシグナルはリアルタイムで算出され、有効な[取引ルール](https://docs.didit.me/ja/transaction-monitoring/rules.md)に照らして評価されます。ルールに一致すると、ルールのアクションに応じて、ユーザーは自動的に`FLAGGED`または`BLOCKED`に移行されることがあります。

## ルールがユーザーに作用する仕組み

取引ルールの`actions`には、次のものを含めることができます。

* `add_score`：取引のリスクスコアを増加させます。
* `change_status`：取引のステータスを設定します(`IN_REVIEW`、`DECLINED`、`AWAITING_USER`)。
* `add_tags`：取引にタグを付けます。
* `add_to_list`：ユーザーの`vendor_data`をブロックリストまたはカスタムリストに追加します。

ルールによってユーザーがブロックリストに追加されると、そのUserエンティティは`BLOCKED`に移行され、`user.status.updated` Webhookが送信されます。

## ユーザーの行動をモニタリングする

Business ConsoleのUser詳細ページにある「取引」タブでは、次のことができます。

* すべての取引を時系列で確認する。
* ステータス、金額、取引方向、取引相手でフィルターする。
* 任意の取引を開き、ルールの実行結果、IPエンリッチメント、暗号資産スクリーニングの結果を確認する。
* ユーザーに対してケースを作成し、調査を追跡する。

## 是正セッション

取引が`AWAITING_USER`になると、Diditは紐付いた**是正セッション**を作成し、ユーザーに追加の認証(例：資金源を示す書類、更新された本人確認書類)の完了を求めます。是正セッションは同じ`vendor_data`に紐付けられており、完了すると取引のステータスが自動的に更新されます。

ステートマシン全体については[取引ステータス](https://docs.didit.me/ja/transaction-monitoring/statuses.md)を参照してください。

## 過去データの取り込み

既存のUserエンティティに対して過去の取引を後から登録するには、過去の日付を`txn_date`に指定します。

```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 '{
    "txn_id": "legacy-0001",
    "txn_date": "2024-03-15T10:00:00Z",
    "direction": "INBOUND",
    "amount": "2500.00",
    "currency": "EUR",
    "applicant": { "vendor_data": "user-42" },
    "counterparty": { "name": "Historic payer" }
  }'
```

> [!NOTE]
>
> 過去の取引もルールエンジンで処理されます。ルールを**トリガーせずに**過去の取引を取り込みたい場合は、「dry ingest」モードに対応したコンソールのインポートフローを使用してください。

## 次のステップ

> [card] [取引を送信する](https://docs.didit.me/ja/transaction-monitoring/transactions.md)
>
> ペイロードの完全なリファレンス。

> [card] [ルール](https://docs.didit.me/ja/transaction-monitoring/rules.md)
>
> ルールが取引を評価し、ユーザーに対してアクションを実行する仕組み。

> [card] [ステータス](https://docs.didit.me/ja/transaction-monitoring/statuses.md)
>
> 取引と是正のステータスのリファレンス。


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