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への添付、規制当局への提出に役立ちます。
コンソールからの書類のアップロード
コンプライアンス担当者は、ユーザーまたは進行中のセッションに対して追加書類をアップロードできます。- Users → [user] → Documents → Upload documentに移動します。
- 書類の種類(ID、POA、カスタム)を選択します。
- ファイルをアップロードします。対応している種類ではOCRが自動的に実行されます。
- 書類は最新のセッションに添付されます(是正用のセッションを作成することもできます)。
書類のアップロード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.updatedWebhookが送信されます。期限が過ぎる前に警告が送信されることはありません。 - 無効にする方法:本人確認の設定で、該当する国と書類の種類についてExpiration modeをAllow expiredに設定します。デフォルトのReject expiredがモニタリングを行うモードです。Allow expiredとして受け付けられた書類は、一切モニタリングされません。
- 再検証:同じ
vendor_dataに対して新しいセッションをトリガーし、書類を更新します。
書類のジオロケーション
ID書類のジオロケーションチェックでは、提出者のIP位置情報とIDの発行国を比較します。結果はセッションの判定に追加されます。プライバシーと保持
- すべての書類は保存時に暗号化されます。
- 画像へのアクセスは、有効期間の短い署名付きURLを介して行われます。
- 保持期間はアプリケーションのデータ保持ポリシーに従います。
- ユーザーには削除を要求する権利があり、削除すると画像、OCRの抽出データ、NFCデータが削除されます。
次のステップ
本人確認
IDの撮影とOCRの仕組み。
住所証明
POA書類の収集。
セッションの判定
GET /v3/session//decision/ のリファレンス。