メインコンテンツへスキップ
ユーザーが認証中にアップロードしたすべての書類は、そのユーザーのUserエンティティに恒久的に紐付けられます。このページでは、収集される内容、その取得方法、追加書類を手動でアップロードする方法を説明します。

Didit が収集する書類

対応書類の種類では、国と書類の組み合わせ一覧(220+の国で14,000+の書類)を確認できます。

書類の取得

書類はユーザーに直接ではなく、その書類を収集したセッションに紐付けられます。ユーザーのすべての書類を一覧表示するには、次の手順に従います。
1

ユーザーのセッションを一覧表示する

2

各セッションの判定を取得する

各セッションの判定には、収集された書類のURLが含まれます。
レスポンス内のid_verification.document_images、proof_of_address.document_images、liveness.imagesフィールドを確認してください。
3

署名付きURLを使用する

レスポンス内の画像URLは、有効期間の短い署名付きURLです。使用する間はクライアント側でキャッシュするか、有効期限が切れたら判定を再取得してください。

PDFレポートの生成

セッションで収集されたすべての内容(すべての書類を含む)を人が読める形式でエクスポートするには、次を使用します。 GET /v3/session/{session_id}/generate-pdf/ セッションの詳細、機能ごとの結果、埋め込まれた書類画像を含むPDFを返します。コンプライアンス監査、SARへの添付、規制当局への提出に役立ちます。

コンソールからの書類のアップロード

コンプライアンス担当者は、ユーザーまたは進行中のセッションに対して追加書類をアップロードできます。
  1. Users → [user] → Documents → Upload documentに移動します。
  2. 書類の種類(ID、POA、カスタム)を選択します。
  3. ファイルをアップロードします。対応している種類ではOCRが自動的に実行されます。
  4. 書類は最新のセッションに添付されます(是正用のセッションを作成することもできます)。
書類のアップロードUIはコンソール専用です。ユーザーに書類を直接添付するための公開APIエンドポイントはありません。すべての書類の取り込みでは、セッションを起点として使用してください。

書類の相互照合

1つのセッションで複数の種類の書類を収集した場合、Diditはそれらを相互に照合します。
  • ID ↔ ライブネス:IDの顔がライブネスのセルフィーと一致します。
  • ID ↔ POA:POA上の氏名がIDから抽出された氏名と一致します。
  • ID ↔ NFC:MRZ / 券面の情報がNFCチップのデータと一致します。
不整合はセッションの判定結果に警告として表示され、手動レビューをトリガーするよう設定できます。

書類のモニタリングと再検証

書類の有効性を継続的に確認する必要があるユースケース(期限切れのIDなど)の場合:
  • 書類の有効期限は、認証済みのすべてのIDで追跡されます。セッションの判定のexpiration_dateフィールドを照会してください。
  • 書類のモニタリング:デフォルトで有効かつ自動で、何も有効化する必要はありません。IDの有効期限が過ぎると、"Approved"のセッションは"Kyc Expired"に移行し、本人確認の結果にDOCUMENT_EXPIREDの警告が追加され、status.updated Webhookが送信されます。期限が過ぎる前に警告が送信されることはありません。
  • 無効にする方法:本人確認の設定で、該当する国と書類の種類についてExpiration modeをAllow expiredに設定します。デフォルトのReject expiredがモニタリングを行うモードです。Allow expiredとして受け付けられた書類は、一切モニタリングされません。
  • 再検証:同じvendor_dataに対して新しいセッションをトリガーし、書類を更新します。

書類のジオロケーション

ID書類のジオロケーションチェックでは、提出者のIP位置情報とIDの発行国を比較します。結果はセッションの判定に追加されます。

プライバシーと保持

  • すべての書類は保存時に暗号化されます。
  • 画像へのアクセスは、有効期間の短い署名付きURLを介して行われます。
  • 保持期間はアプリケーションのデータ保持ポリシーに従います。
  • ユーザーには削除を要求する権利があり、削除すると画像、OCRの抽出データ、NFCデータが削除されます。

次のステップ

本人確認

IDの撮影とOCRの仕組み。

住所証明

POA書類の収集。

セッションの判定

GET /v3/session//decision/ のリファレンス。
最終更新日 2026年11月1日