メインコンテンツへスキップ
Business Consoleを使うと、チームはコードを書かずにUserエンティティを一括管理できます。CSVインポート(ユーザーを大量に作成または更新)とCSVエクスポート(外部ツール向けにユーザーテーブルを抽出)の2つのフローに対応しています。
ここでの一括インポート/エクスポートは、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

顔をアップロードする

顔は有効な画像で、デコード後のサイズが最大2MBであり、検出可能な顔を含んでいる必要があります。Diditはそれをプロファイルに保存し、重複検出と顔検索のためにインデックス化します。別途リストへの顔のアップロードエンドポイントを使用しない限り、顔ブロックリストには追加されません。

CSVにユーザーをエクスポートする

利用シーン

  • コンプライアンス監査: ユーザーテーブル全体を監査人に提出します。
  • データウェアハウスとの同期: BIツール向けに定期的にデータを出力します。
  • SAR/規制当局からの要請: フィルターで絞り込んだユーザーのサブセットを抽出します。

エクスポートの実行

  1. Users → Exportに移動します。
  2. フィルター(ステータス、国、日付範囲、検索)を適用します。
  3. 列を選択します(デフォルトはすべてのフィールドで、不要な列は除外できます)。
  4. 送信します。Diditはエクスポートを非同期で生成し、署名付きのダウンロードリンクをリクエストを行ったオペレーターにメールで送信します。
エクスポートには、ご自身の役割で閲覧が許可されているデータのみが含まれます。COMPLIANCE_OFFICER以上はテーブル全体をエクスポートできます。DEVELOPERおよびREADERの役割はエクスポートが制限されます。

パフォーマンス特性

監査証跡

すべてのインポートとエクスポートは監査ログに記録されます。
  • 実行したオペレーター。
  • 行数(インポート)/フィルターのスナップショット(エクスポート)。
  • タイムスタンプと成功/失敗の状態。

次のステップ

ユーザー作成API

スクリプトを使用したインポート向けに、プログラムでユーザーを作成します。

ユーザーの顔のアップロード

インポートした顔画像をUserプロファイルに添付します。

データ保持

インポートしたデータが保持される期間。

監査ログ

インポート/エクスポートの履歴を確認します。
最終更新日 2026年11月1日