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

# KYBステータスリファレンス：セッション・機能・AML

> DiditのKYBセッション、機能、法人登記照会、AMLスクリーニングの正確なステータス文字列と機能名の一覧です。料金は国とレベルごとに設定され、1件あたり$2.00から。

法人確認では、**セッション**、個々の**機能**、**登記照会**、**AML結果**という複数のレベルでステータスを追跡します。このページは、すべての状態のリファレンスです。

APIは、ステータス値を`"In Progress"`や`"Not Finished"`のような、大文字と小文字を区別する正確なラベルとして返します。これはWebhookが送る文字列と同じです。
大文字の名前ではなく、これらの文字列で照合してください。

## セッションのステータス

法人確認 (KYB) セッション全体のステータスです。分岐処理で最もよく使う単一のフィールドです。

| ステータス | 意味 |
| - | - |
| `"Not Started"` | セッションは作成済みですが、企業がまだホスト型リンクを開いていません。 |
| `"In Progress"` | ホスト型フローが進行中です。登記照会、書類のアップロード、またはAMLスクリーニングが行われています。 |
| `"Awaiting User"` | エンドユーザーのアクションを待っています(通常は主要人物の提出、または再提出リクエストへの対応)。ユーザーが保留中のアクションを完了すると、自動的に遷移します。 |
| `"Approved"` | 必要なすべての機能で合格しました。企業は検証済みです。 |
| `"Declined"` | 重要なチェックが不合格になった(解散した会社、制裁対象の事業体、ブロックリスト登録)か、ワークフローのルールにより却下されました。 |
| `"In Review"` | 1つ以上の機能で、アナリストによる手動レビューが必要です。 |
| `"Resubmitted"` | 以前に却下された、または再提出をリクエストされたセッションが、更新されたデータで再提出されました。 |
| `"Abandoned"` | 企業がフローを完了しませんでした(タイムアウト)。 |
| `"Expired"` | 企業が完了する前に、セッションの有効期限が切れました。 |

> [!NOTE]
>
> `"Awaiting User"`は一時的な状態であり、セッションを手動でこの状態から移す必要はありません。エンドユーザーが保留中のアクションを完了すると(例: 主要人物リストの提出や、リクエストされた書類の再アップロード)、Diditはすぐにセッションを再評価し、結果に応じて自動的に`"In Review"`、`"Approved"`、または`"Declined"`に遷移させます。

## 機能のステータス

KYBの各機能には独自のステータスがあり、それらがセッションのステータスに集約されます。

| ステータス | 意味 |
| - | - |
| `"Not Finished"` | 機能がまだ開始されていないか、実行中です。 |
| `"Approved"` | 機能が承認されました。 |
| `"Declined"` | 機能が失敗しました（重大）。 |
| `"In Review"` | 機能について、アナリストの対応が必要です。 |
| `"Resub Requested"` | 企業はこの機能について再提出する必要があります(例: 書類の再アップロード)。 |
| `"Awaiting User"` | 機能がエンドユーザーのアクションを待っています。ユーザーが関係者の情報を提出する必要がある場合、主要人物機能に適用されます。情報の提出後に自動的に遷移します。 |

### KYBの機能名

KYBセッションおよびWebhookにおける`features`の値は次のとおりです。

* `KYB_REGISTRY`: 法人登記の照会。
* `AML`: 会社単位のAMLスクリーニング。
* `KYB_DOCUMENTS`: 書類の収集とOCR。
* `KYB_KEY_PEOPLE`: 主要人物。UBO、株主、取締役、代表者、その他の役員です。

## 登記ステータス (プロバイダー提供)

信頼できる登記情報源から取得した、会社の公式ステータスです。管轄区域ごとの登記簿が報告する事業体の法的または規制上の地位を反映するため、正確な値は情報源によって異なります。KYB判定内の`company.registry_status`に表示されます。

| ステータス | 意味 |
| - | - |
| `ACTIVE` | 会社は活動中で、適法に存続しています。 |
| `DISSOLVED` | 会社は解散しています。 |
| `DEREGISTERED` | 会社は登録を抹消されています。 |
| `STRUCK_OFF` | 会社は登記簿から除名されています。 |
| `CLOSED` | 会社は閉鎖されています。 |
| `INACTIVE` | 会社は休眠中です(営業していません)。 |
| `AUTHORISED` | 認可済みです(通常は規制対象の事業体)。 |
| `APPOINTED_REPRESENTATIVE` | 他の認可事業者の指定代理人です。 |
| `UNAUTHORISED` | 以前は認可されていましたが、現在は認可されていません。 |
| `NO_LONGER_AUTHORISED` | 認可が取り消されています。 |
| `SEE_FULL_DETAILS` | ステータスの手動確認が必要です。 |

> [!NOTE]
>
> `registry_status`は登記簿に記載された値そのものを反映するため、プロダクトロジックに使用するために管轄区域を問わず一貫した指標が必要な場合は、後述の`verification_status`を使用してください。

## 会社の検証ステータス

会社の結果ごとに付与される、企業向けの標準化されたステータスです。国や情報源によって異なる登記ステータスや会社ステータスを、プロダクト内でそのまま解釈できる単一の一貫した指標に正規化します。KYB判定内の`company.verification_status`に表示されます。

| ステータス | 意味 |
| - | - |
| `verified` | 会社は活動中で有効であると見られます。 |
| `failed` | 会社は非アクティブまたは解散しているか、問題が特定されていると見られます。 |
| `unknown` | 情報が不十分であるか、ステータスが曖昧です。 |

## 会社情報の取得ステータス

外部または公的な登記簿から特定の会社レコードのデータを取得する際の進捗状況を示します。特定の会社について、取得した情報がどの程度揃っているかを判断するために使用します。KYB判定内の`company.fetch_status`に表示されます。

| ステータス | 意味 |
| - | - |
| `pending` | この段階では、会社の部分的または基本的な情報のみが取得されています。 |
| `resolved` | 公式の情報源から、完全な会社データが正常に取得されました。 |

## AML検証ステータス

スクリーニング(会社または個人)ごとに返されます。

| ステータス | 意味 |
| - | - |
| `"Approved"` | しきい値を超えるヒットはありません。 |
| `"Declined"` | 重大度の高いヒットです(制裁またはPEPとの一致が確認済み)。 |
| `"In Review"` | アナリストのレビューが必要なヒットが見つかりました。 |
| `"Not Finished"` | スクリーニングが完了していません。 |

## 判定の根拠の示し方

KYBの判定には、単一の理由コード文字列は含まれません。
各機能の配列(`registry_checks[]`、`document_verifications[]`、`key_people_checks[]`、`aml_screenings[]`)には、`KYB_*`タグとAMLタグを含む`warnings[]`があり、`decision_trace`には判定に至った経緯が記録されます。
タグの意味は[KYBの警告](https://docs.didit.me/ja/business-verification/warnings.md)で確認し、セッションのステータスと合わせてログに記録してください。

プラットフォーム自身の集計結果とは異なるステータスをレビュアーが手動で設定した場合、判定には`status_override`が含まれ、`overridden_at`の時刻と、プラットフォームが設定するはずだった`automatic_status`が記録されます。
[レスポンススキーマ](https://docs.didit.me/ja/business-verification/response-schema.md)を参照してください。

## 次のステップ

> [card] [レスポンススキーマ](https://docs.didit.me/ja/business-verification/response-schema.md)
>
> 各ステータスがペイロードのどこに現れるか。

> [card] [リスク評価](https://docs.didit.me/ja/business-verification/risk-assessment.md)
>
> KYBの結果を左右する要因。

> [card] [Webhook](https://docs.didit.me/ja/business-verification/webhooks.md)
>
> ステータスの変化時に発生するイベント。


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