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

# 企業の取引履歴API：KYT取引データの取得

> Didit の企業エンティティの取引履歴を取得し、継続的な取引が取引モニタリングのベロシティ、行動分析、スクリーニングの各ルールにどう反映されるかを確認できます。

`vendor_data`識別子が企業エンティティと一致する状態で送信したすべての取引は、申請者、送金人、受取人、取引相手のいずれの立場であっても、その企業プロフィールに紐付けられます。企業プロフィールはその活動を継続的に記録する台帳となり、トランザクションモニタリングはこの履歴を企業レベルのベロシティ、行動、スクリーニングの各ルールの入力として使用します。

## 企業の取引を取得する

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

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

企業が申請者として登場するすべての取引が返されます。取引相手側の履歴については、Business Consoleでフィルタリングしてください（公開一覧エンドポイントでは、申請者のみを対象にフィルタリングされます）。

## 取引と企業の紐付け方法

```mermaid theme={null}
flowchart LR
    T["Transaction<br/>txn_id=tx-0042"]
    A["applicant:<br/>vendor_data=biz-acme"]
    C["counterparty:<br/>vendor_data=biz-widgets"]
    B1[Business: biz-acme]
    B2[Business: biz-widgets]
    T --> A
    T --> C
    A -.-> B1
    C -.-> B2
```

各取引には最大4つの当事者(`applicant`、`remitter`、`beneficiary`、`counterparty`)が含まれます。当事者にアプリケーション内の企業エンティティと一致する`vendor_data`が含まれている場合、Diditはその当事者を該当する企業に紐付けます。`vendor_data`のない当事者は外部スナップショットとして保存されます(エンティティへの紐付けはありません)。

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

## 混在する当事者の種類

1件の取引で、当事者ごとにユーザーと企業を混在させることができます。たとえば、個人ユーザーが企業に支払う場合は次のとおりです。

```json theme={null}
{
  "txn_id": "tx-0099",
  "direction": "OUTBOUND",
  "amount": "500.00",
  "currency": "EUR",
  "applicant": { "vendor_data": "user-42" },
  "counterparty": { "vendor_data": "biz-acme" }
}
```

また、2つの企業間のB2B送金の場合は次のとおりです。

```json theme={null}
{
  "txn_id": "tx-0100",
  "direction": "OUTBOUND",
  "amount": "120000.00",
  "currency": "USD",
  "applicant": { "vendor_data": "biz-acme" },
  "counterparty": { "vendor_data": "biz-widgets" }
}
```

Diditは`vendor_data`に基づいて各当事者を個別に識別します。同じ取引が、一致したすべてのエンティティのプロフィールに反映されます。

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

取引は、次の企業レベルのシグナルにデータを提供します。

| シグナル | 使用するルール |
| - | - |
| 入金/出金の総額 | ベロシティルール、しきい値設定 |
| 一定期間内の取引件数 | ベロシティルール |
| ユニークな取引相手の数 | 行動ルール |
| 取引に関与する高リスク法域 | 地域ルール |
| 制裁対象の取引相手へのエクスポージャー | スクリーニングルール |
| 支払い方法の多様性 | 不正ルール |

これらのシグナルはリアルタイムで計算され、有効な[取引ルール](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`をブロックリストまたはカスタムリストに追加します。

ルールによって企業がブロックリストに追加されると、企業エンティティは`BLOCKED`に移行し、`business.status.updated` Webhookが送信されます。

## 企業の行動をモニタリングする

Business Consoleの企業詳細ページにある取引タブを使うと、次のことができます。

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

## 企業が所有する支払い方法

各取引には、1つ以上の支払い方法(銀行カード、銀行口座、電子ウォレット、暗号資産ウォレット)を添付できます。支払い方法を企業が所有している場合、`vendor_data`を通じて企業に紐付けられます。そのため、企業がこれまでに使用したすべての支払い方法を企業詳細ページで直接確認できます。

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

既存の企業に対して過去の取引をさかのぼって登録するには、過去の日付を`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": "25000.00",
    "currency": "EUR",
    "applicant": { "vendor_data": "biz-acme" },
    "counterparty": { "name": "Historic payer" }
  }'
```

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

## 次のステップ

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