メインコンテンツへスキップ
すべてのBusinessエンティティには主要人物が存在します。主要人物とは、企業に対して法的責任を負う自然人、または企業を実質的に所有する自然人です。DiditはKYBの過程でこれらの人物を特定し、それぞれをUserエンティティに紐付けて個人のKYCを実施できるようにします。

主要人物に該当する人

役割の完全な分類と所有関係の連鎖の算出については、KYB役員および所有構造のページを参照してください。

主要人物がBusinessに紐付く仕組み

1

法人登記からの特定

KYBの過程で、Diditは法人登記を照会し、記載されているすべての役員と株主を抽出します。各人物は、法人確認 (KYB) セッションに紐付く主要人物レコードになります。
2

ユーザーによる追加(顧客による入力)

ワークフローには「主要人物」ステップを含めることができ、企業の管理者が法人登記に記載されていない人物(法人による申告で特定されたUBOなど)を追加できます。
3

Businessエンティティへの集約

Businessの主要人物リストは、法人登記から抽出された人物とユーザーが追加した人物を合わせたもので、同一人物に基づいて重複が排除されます。
各主要人物にはsourceフィールドがあります。
  • REGISTRY:公的な法人登記から抽出されたもの。
  • USER:KYBフローの中で企業の管理者が追加したもの。

主要人物をUserエンティティに紐付ける

主要人物(通常はUBOと取締役)にKYCが必要な場合、その当事者をUserエンティティに紐付けることができます。 紐付けは次の場合に作成されます。
  • Userエンティティと同じvendor_dataを使用して、その当事者のユーザー認証 (KYC) セッションが実行された場合。
  • アナリストが企業に関連する当事者を既存のUserに手動で関連付けた場合。
紐付けが完了すると、UserのKYCステータスがBusinessの主要人物ビューに反映されます。

主要人物の確認

コンソールのBusiness詳細ページでは、主要人物タブに次の情報が表示されます。
  • 各当事者の氏名、役割、所有比率(%)、ソース(法人登記またはユーザーによる追加)
  • 紐付けられたユーザーのKYCステータス
  • 人物ごとのAMLスクリーニングのステータス
  • 関連書類(取締役の身分証明書、UBO申告書)
プログラムからは、主要人物は法人確認 (KYB) セッションの判定に含まれるkey_people_checks[]配列内に、2つのバケットに分かれて表示されます。
  • registry.officers / registry.beneficial_owners:法人登記チェックで見つかった当事者。
  • submitted.parties:主要人物フローの中で企業の管理者が追加した当事者(source: USER)。
  • ubo_kyc_summary:UBOのKYC進捗の集計。
従来のフラットなofficers[]およびbeneficial_owners[]配列は、後方互換性のためにあと1リリースの間レスポンスに残ります。新しい連携では、上記の2バケット形式を使用してください。すべてのフィールドについては、KYBレスポンススキーマの全体を参照してください。

法人株主

株主が個人ではなく企業である場合、Diditは所有関係を再帰的にたどり最終的な実質的支配者を特定します。法人である当事者は、必要に応じて子の法人確認 (KYB) セッションをトリガーできます。 多層的な所有構造の具体例については、所有構造を参照してください。

主要人物のWebhook

主要人物の変更は、親セッションのイベントを通じて通知されます。
  • data.updated(session_kind: "business"付き):主要人物を含むセッションデータが更新されました。
  • status.updated(session_kind: "business"付き):その結果としてセッションのステータスが変更されました。
ペイロードについては、KYB Webhookを参照してください。

次のステップ

役員

取締役の特定と役割の分類。

所有構造

UBO、法人株主、チェーンの算出。

主要人物フロー

主要人物を収集するKYBステップ。
最終更新日 2026年11月1日