ここでの一括インポート/エクスポートは、Userプロファイルの作成または更新のみを行います。過去のKYCセッション、書類の警告、ライブネスの証跡、プロバイダーによる判定は再作成されません。Sumsub、MetaMap、Veriff、Onfido、Persona、またはその他のプロバイダーからの完全な移行については、他のプロバイダーからのデータのインポートを参照してください。
CSVからユーザーをインポートする
利用シーン
- 導入時の移行: 他のKYCベンダーから既存のユーザー名簿を移します。
- プロバイダーの顔データの移行: Userの行を作成した後、インポートしたUserプロファイルに信頼できる顔画像を添付します。
- パートナーの顧客リストの一括オンボーディング。
- メタデータの補完: 多数のユーザーのタグ、レベル、社内識別子をまとめて更新します。
テンプレートの列
Users → Import → Download templateからテンプレートをダウンロードします。列は次のとおりです。インポートの実行
1
CSVをアップロードする
Users → Import → Upload CSVに移動し、ファイルを選択します。
2
プレビューを確認する
コンソールが各行を検証します。無効な行はエラー理由(
vendor_dataの重複、無効な国コードなど)とともにハイライト表示されます。3
インポートを開始する
Diditは行を非同期で処理します。タブを閉じても問題ありません。進捗はUsers → Import historyで確認できます。
4
結果を確認する
インポートが完了すると、履歴ビューに作成、更新、スキップされた行の件数と、ダウンロード可能なエラーレポートが表示されます。
更新と作成
vendor_dataが存在しない場合、新しいUserが作成されます。vendor_dataがすでに存在する場合、その行の内容で既存のUser(プロファイルフィールドとメタデータ)が更新されます。- 集計カウンターと検証済みフィールド(承認済みセッション由来の
full_name、date_of_birth)は、インポートによって上書きされることはありません。
ユーザー作成後に顔をインポートする
CSVインポートはUserの行を作成または更新します。CSVに顔画像は含まれません。他のプロバイダーから顔の生体情報を移行するには、対象のUserを作成またはインポートしてから、各顔をアップロードします。1
Userを作成またはインポートする
コンソールのCSVインポートを使うか、
POST /v3/users/create/をループで呼び出します。2
didit_internal_idを取得する
GET /v3/users/{vendor_data}/でUserを取得します。レスポンスにdidit_internal_idが含まれます。3
顔をアップロードする
CSVにユーザーをエクスポートする
利用シーン
- コンプライアンス監査: ユーザーテーブル全体を監査人に提出します。
- データウェアハウスとの同期: BIツール向けに定期的にデータを出力します。
- SAR/規制当局からの要請: フィルターで絞り込んだユーザーのサブセットを抽出します。
エクスポートの実行
- Users → Exportに移動します。
- フィルター(ステータス、国、日付範囲、検索)を適用します。
- 列を選択します(デフォルトはすべてのフィールドで、不要な列は除外できます)。
- 送信します。Diditはエクスポートを非同期で生成し、署名付きのダウンロードリンクをリクエストを行ったオペレーターにメールで送信します。
エクスポートには、ご自身の役割で閲覧が許可されているデータのみが含まれます。COMPLIANCE_OFFICER以上はテーブル全体をエクスポートできます。DEVELOPERおよびREADERの役割はエクスポートが制限されます。
パフォーマンス特性
監査証跡
すべてのインポートとエクスポートは監査ログに記録されます。- 実行したオペレーター。
- 行数(インポート)/フィルターのスナップショット(エクスポート)。
- タイムスタンプと成功/失敗の状態。
次のステップ
ユーザー作成API
スクリプトを使用したインポート向けに、プログラムでユーザーを作成します。
ユーザーの顔のアップロード
インポートした顔画像をUserプロファイルに添付します。
データ保持
インポートしたデータが保持される期間。
監査ログ
インポート/エクスポートの履歴を確認します。