> ## 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取引モニタリングにおける取引・ケース・トラベルルールの全ステータスと、その遷移や意味をまとめたリファレンスです。毎月1,000件の取引まで含まれ、それ以降は1件あたり$0.001です。

トランザクションモニタリングには、**取引**、各**ケース**、そして（該当する場合）**トラベルルールチェック**という3つの独立したステータスマシンがあります。このページはそのリファレンスです。

## 取引ステータス

作成時に設定され、ライフサイクルを通じて更新されます。

| ステータス | 意味 |
| - | - |
| `APPROVED` | 取引がすべてのルールを通過し、スコアがレビューのしきい値を下回りました。 |
| `IN_REVIEW` | スコアがレビューのしきい値を超えたか、ルールが明示的にレビューを要求しました。アナリストによる確認が必要です。 |
| `DECLINED` | スコアが却下のしきい値を超えたか、ルールが明示的に却下しました。取引は拒否されます。 |
| `AWAITING_USER` | 取引の決済を完了する前に、ユーザーによる対応が必要です。Diditはこのステータスをルールを通じてのみ設定します。具体的には、ルールの`change_status`アクション（たとえば、`ON_HOLD`のトラベルルール送金で発火するオプトインのライブラリルール`travel-rule-pending-action`）、または追加の検証を要求したルールアクション（是正用のセッションが作成された場合）です。ウォレットの管理権の証明が必要なトラベルルール送金は、それ自体ではこのステータスを設定しません。取引はルールが与えるステータス（通常は`APPROVED`）を維持し、ウィジェットセッションが保留中の場合は常に`action_required`ブロックにウォレット所有確認用のURLが含まれます。具体的なアクションとURLは、取引の`action_required`ブロックで確認してください。 |

### 遷移

```mermaid theme={null}
stateDiagram-v2
    [*] --> APPROVED: Score < review threshold, no blocking rules
    [*] --> IN_REVIEW: Score >= review threshold
    [*] --> DECLINED: Score >= decline threshold, or rule decline action
    [*] --> AWAITING_USER: Rule action change_status → AWAITING_USER
    IN_REVIEW --> APPROVED: Analyst cleared
    IN_REVIEW --> DECLINED: Analyst declined
    AWAITING_USER --> APPROVED: Remediation session approved
    AWAITING_USER --> DECLINED: Remediation session declined
    AWAITING_USER --> IN_REVIEW: Remediation session ended in review
```

注：トラベルルール以外では、`APPROVED`または`DECLINED`から他のステータスへ直接戻る遷移はありません。
トラベルルールの期限切れ時には、現在のステータスにかかわらず、`timeout_outcome`によって`IN_REVIEW`（`HOLD`）または`DECLINED`（`REJECT`）が設定されます。また、トラベルルールの遷移後に発火したルールが`APPROVED`の取引のステータスを変更することもあります。
修正にはコンソールからのステータスパッチを使用してください。これらは監査ログに記録されます。

## アラート

アラート専用のステータスはありません。
未対応のアラートとは、`IN_REVIEW`または`AWAITING_USER`の取引のことなので、上記の取引ステータスを使用してください。
[アラート](https://docs.didit.me/ja/transaction-monitoring/alerts.md)を参照してください。

## ケースステータス

詳細は[ケース管理](https://docs.didit.me/ja/console/case-management/cases.md)を参照してください。

| ステータス | 意味 |
| - | - |
| `OPEN` | 調査中です。 |
| `AWAITING_USER` | ユーザー側からの入力を待っています。 |
| `RESOLVED` | 解決内容（`FALSE_POSITIVE`、`VALID_THREAT`、`INCONCLUSIVE`、`REQUIREMENTS_NOT_MET`、`REQUIREMENTS_SATISFIED`のいずれか）を付けてクローズされました。 |

ケースには、これとは別に**優先度**（`LOW`、`MEDIUM`、`HIGH`）があります。

## トラベルルールチェックのステータス

FATFトラベルルールの対象となる暗号資産の送金では、上記の取引ステータスとは別に、専用の**13の状態から成るやり取り**が実行されます。
送信側の送金は、`AWAITING_COUNTERPARTY`、`NOT_APPLICABLE`（`threshold_amount`未満）、`UNCONFIRMED_OWNERSHIP`（取引相手のウォレットがセルフホスト型と申告された場合）、`COMPLETED`または`COUNTERPARTY_MISMATCHED_DATA`（検証済みウォレットとの`INTERNAL`一致の場合。どちらになるかは名前の一致結果によります）、`COUNTERPARTY_VASP_NOT_FOUND`、または`COUNTERPARTY_VASP_NOT_REACHABLE`から開始します。
受信側の送金は`ON_HOLD`または`NOT_ENOUGH_COUNTERPARTY_DATA`から開始することもあります。また、検証済みウォレットと一致し、受取人名が一致するか指定されていないサンライズ登録は、`COMPLETED`を経てそのまま`FINISHED`に進みます。
やり取りは`FINISHED`、`CANCELLED`、または`EXPIRED`で終了します。

| ステータス | 意味 |
| - | - |
| `AWAITING_COUNTERPARTY` | 取引相手に送信済みで、応答を待っています。TRUST経由で送信された送金は、Diditが読み取れる応答をTRUSTが何も返さないため、期限切れになるまでこのステータスのままです。サンドボックスのアプリケーションでは、送金は[Didit Test VASP](https://docs.didit.me/ja/transaction-monitoring/travel-rule-sandbox.md)に送られ、選択したシナリオに沿ってDidit内で応答します。 |
| `UNCONFIRMED_OWNERSHIP` | 受取人のウォレットの所有権がまだ証明されていません。 |
| `ON_HOLD` | Diditは受信側の送金にのみこのステータスを設定します。対象は、ウォレットがアドレス帳にないサンライズ登録または受信`TRP`照会（名前のみの照会の場合は、名前が単一の検証済み保有者と一致しないもの）、または手動での判定が必要な受信`TRP`照会（自動承認がオフの場合、または自動返信を配信できなかった場合）です。それ自体では取引ステータスを変更しません。`AWAITING_USER`を設定するのは、オプトインのライブラリルール`travel-rule-pending-action`です。`POST /v3/transactions/{id}/travel-rule/ownership/`で解決してください。 |
| `COMPLETED` | 送金人と受取人のデータが一致しました。オンチェーンでのブロードキャストを安全に行えます。 |
| `FINISHED` | オンチェーンのハッシュが報告され、やり取りが終了しました。 |
| `CANCELLED` | 終了状態ではないステータスからキャンセルされました。 |
| `EXPIRED` | 確認のタイムアウト時間が経過しました。期限切れになるのは、期限の時点でまだ`AWAITING_COUNTERPARTY`にある送金のみで、15分ごとにチェックされます。その他のステータスがタイムアウトすることはありません。取引には`timeout_outcome`が適用されますが、この変更では`transaction.status.updated`のWebhookは送信されません。 |
| `COUNTERPARTY_MISMATCHED_DATA` | 受取人名が一致しませんでした。 |
| `COUNTERPARTY_VASP_NOT_FOUND` | どのレールでも取引相手を特定できませんでした。 |
| `COUNTERPARTY_VASP_NOT_REACHABLE` | 取引相手は特定できたものの、Diditが配信できませんでした。原因は、相手の`TRP`エンドポイントに到達できなかった、異なるLEIを報告したかLEIを報告しなかった、異なる名前を報告した、またはネットワークレール（GTR、TRUST、VerifyVASP、Sygna Bridge）がメッセージを配信できなかった、のいずれかです。 |
| `COUNTERPARTY_VASP_GENERAL_DECLINE` | 取引相手がやり取りを拒否しました。 |
| `NOT_ENOUGH_COUNTERPARTY_DATA` | 受信`TRP`照会が、受取人を名前でもウォレットアドレスでも特定していませんでした。期限がなく、所有権エンドポイントでは解決できないため、`action: "cancel"`でキャンセルしてください。送信者には通知されません。Diditが送信側の送金にこのステータスを設定することはなく、送信側で表示されるのは自分で記録した場合のみです。そのような送金は`action: "resend"`で再試行できます。 |
| `NOT_APPLICABLE` | `threshold_amount`未満のため何もやり取りされなかったか、Diditがトラベルルールチェックを実行しない送金に記録した値です（トラベルルールが無効の場合、タイプが`travelRule`ではない取引、またはレガシー値）。 |

古い連携では、レガシー値の`UNKNOWN`、`COMPLIANT`、`PENDING_ACTION`、`PENDING_COUNTERPARTY`、`FAILED`、`EXEMPT`が引き続き送信される場合があります。Diditはこれらを上記のステータスに自動的にマッピングします。

正式なリファレンスは[トラベルルール](https://docs.didit.me/ja/transaction-monitoring/travel-rule.md#ライフサイクル)を参照してください。

## プロバイダー結果ステータス

外部プロバイダーの結果(ウォレットスクリーニング、法定通貨モニタリング、制裁スクリーニング)は、それぞれ固有のステータスとともに保存されます。取引のレスポンスでは`provider_results[]`に含まれます。

| ステータス | 意味 |
| - | - |
| `PENDING` | プロバイダーへの照会が処理中です。 |
| `COMPLETED` | 結果が正常に返されました。 |
| `FAILED` | プロバイダーでエラーまたはタイムアウトが発生しました。 |
| `SKIPPED` | プロバイダーが意図的にスキップされました(例: 取引額がしきい値未満の場合)。 |

## ルール実行の結果

各`TransactionRuleRun`には次の項目があります。

* `matched`(boolean): ルールが発動したかどうか。
* `is_test`(boolean): ルールがTESTモードだったかどうか。
* `mode`: 評価時点の`ACTIVE`、`DISABLED`、`TEST`のいずれか。
* `score_delta`: スコアへの寄与分(一致し、かつアクティブな場合)。
* `status_target`: ルールが要求したステータス(`change_status`アクションの場合)。

ルールの構成については[ルール](https://docs.didit.me/ja/transaction-monitoring/rules.md)を参照してください。

## 判定理由コード

ステータス遷移時によく使われる`reason`の値:

| 理由 | 意味 |
| - | - |
| `rule_score_threshold` | スコアがレビューまたは却下のしきい値を超えました。 |
| `rule_change_status` | ルールの`change_status`アクションによってステータスが強制的に変更されました。 |
| `analyst_approved` / `analyst_declined` / `analyst_cleared` | アナリストによる手動アクション。 |
| `user_action_approved` / `user_action_declined` / `user_action_in_review` | 紐づけられた是正セッションの結果(`AWAITING_USER`の間に要求されたユーザーアクション)。 |
| `provider_update` | 外部プロバイダーが結果を更新しました。 |
| `aml_confirmed_sanction` | AMLスクリーニングで制裁リストとの一致が確認されました。 |
| `blocklist_applicant` / `blocklist_counterparty` | 当事者に対するブロックリストの適用。 |

## 次のステップ

> [card] [リスクスコアリング](https://docs.didit.me/ja/transaction-monitoring/risk-scoring.md)
>
> スコアとステータスの対応関係。

> [card] [アラート](https://docs.didit.me/ja/transaction-monitoring/alerts.md)
>
> アラートのライフサイクル。

> [card] [ケース](https://docs.didit.me/ja/transaction-monitoring/cases.md)
>
> ケースのライフサイクル。


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