顔照合1:1 API: セルフィーと身分証明書の比較

Didit の顔照合は、2つの顔を1:1で比較します。通常は、ライブネスチェックで撮影したセルフィーと、ユーザーの身分証明書の顔写真を比較し、0から100の類似度スコアを返します。設定したしきい値によってチェックに合格するかどうかが決まります。スタンドアロンの POST /v3/face-match/ API は、デフォルトでスコアが30以下の場合に不合格 (Declined) とします。 確認結果の読み方に関するアカデミーのレッスンでは、6:16 の章で、実際のセッション内の顔照合チェックを取り上げています。

​

リトライと具体的なフィードバック

Didit のセッションでは、修正可能な撮影上の理由 (セルフィーが暗すぎる、ぼやけている、中心からずれている、類似度がぎりぎりであるなど) で顔照合が失敗しても、すぐには不合格になりません。ユーザーは、設定可能な回数まで、ガイダンスを受けながらやり直す ように求められます。これは ライブネス検知 と同じモデルです。

• 試行回数の上限 - face_match_max_attempts が、セッションあたりの顔照合の送信回数の合計を制御します。デフォルトは 3 (最初の試行1回とリトライ2回) で、ワークフローのノードごとに設定できます (範囲は1～3)。
• リトライ時のフィードバック - 試行回数が残っている間は、リトライ可能な失敗の場合、ユーザーはそのステップに留まり、feedback_codes が返されます (Web SDK とモバイル SDK は、これらを自動的にコーチングのメッセージとして表示します)。
  {
    "detail": "Make sure your face matches your document photo, improve lighting and try again.",
    "error": "LOW_FACE_MATCH_SIMILARITY",
    "feedback_codes": ["LOW_FACE_MATCH_SIMILARITY"],
    "attempts_used": 1,
    "max_attempts": 3
  }
  
• 上限到達後 - 試行回数の上限に達すると、算出されたステータス (Declined または In Review) が適用されます。

​

仕組み

---

​

書類の要件

確認を確実に成功させるには、書類が次の基準を満たしている必要があります。

​

一般的な要件

• 政府が発行したもので、設定された有効期間内であること
• 物理的に損傷がないこと (傷、汚れ、破損により詳細が隠れていないこと)
• すべての重要な情報 (氏名、生年月日、MRZ など) がはっきりと判読できること
• 提出されたすべての書類で、データが一貫していること

​

画像の要件

• 原本をリアルタイムで撮影した写真であること (スクリーンショット、スキャン、デジタルコピーは不可)
• 対応フォーマット: JPG、JPEG、PNG、PDF
• 最大ファイルサイズ: 5MB
• 書類の四隅がすべて写っているフルカラーの画像であること
• 反射、影、デジタル編集、加工がないこと
• 物理的な書類が必要です (デジタル ID は、公式に認められている一部の地域でのみ対応します)

​

国と書類の種類ごとの追加設定

コンソールから直接、国と書類の種類ごとに細かいルールを設定できます。これらのコントロールにより、受け入れ基準と文字表記の設定を、コンプライアンスのニーズに合わせて調整できます。

• 有効期限モード: 有効期限が過ぎた書類の扱い方を選択します。
  • 期限切れを拒否: 書類の有効期限が今日より前の場合、期限切れとしてマークして拒否します。
  • 期限切れを許可: 有効期限が過ぎた書類にフラグを立てたりブロックしたりしません。
• 優先する文字形式: 抽出された氏名や項目を、どのように正規化するかを選択します。
  • ラテン文字 (A-Z) を優先: 例: “Mohammed”
  • 原語の文字 (非ラテン文字) を優先: 例: “محمد”
• 地域別の対応とサブタイプ: 地域ごとに書類を有効にし、書類の種類に多くのバリエーションがある場合は、受け入れ可能なサブタイプを指定します。
  • 例: 米国の運転免許証では、受け入れる正確なサブタイプ (たとえば、アリゾナ州の商用運転免許証、インディアナ州の運転免許証 (REAL ID)、ニューヨーク州の強化運転免許証など) を選択します。
  • 「受け入れるサブタイプ」のコントロールを使うと、多数のバリエーション (たとえば「128件選択済み」) をまとめて含めたり除外したりできます。

ヒント: これらの設定は国と書類の種類ごとに適用されるため、市場によっては厳格に、他の市場では柔軟に運用できます。