メインコンテンツへスキップ
BrazilSerpro類似度返却

給与担保ローン（INSS）およびSerproデータベースとの照合が必要な操作に特化したCapability。撮影されたセルフィーとSerproに登録された顔写真の類似度スコアを返します。

機能概要​

このCapabilityは、セッションのセルフィーと提供されたCPFに紐付くSerproの顔写真を照合します。照合が可能な場合は0〜100のスコアを返し、Serproが顔を見つけられない場合やSerproとの連携に失敗した場合は特別なコード（-1、-2）を返します。

入力​

  • Serpro類似度を含むフローで POST /v1/process を通じて開かれたキャプチャセッション。
  • ユーザーのCPF。
  • Serpro Capabilityに対する事前のテナント有効化（Unicoオンボーディングチームとの協議が必要）。

返却される可能性のあるレスポンス​

レスポンス意味
スコア 0〜100Serproが顔を検出した場合。スコアが高いほど類似度が高い。
スコア -1Serproが当該CPFに紐付く顔を見つけられなかった場合。
スコア -2Serproとの連携エラー — スコアを取得できなかった場合。
スコア -1 と -2 は低スコアではありません

これらは異なるシナリオを示すシグナルコードです。ゼロスコアと同様に扱うと誤った判断につながります。

対応状況​

サーフェス対応
SDK（Android、iOS、Flutter）✅
Web（iFrame、リダイレクト）✅
API（ヘッドレス、SDK不使用）✅
有効化が必要

対応サーフェスであっても、テナントがSerpro Capabilityに対して有効化されている必要があります。まだアクセスできない場合は、Unicoのオンボーディングチームにお問い合わせください。

有効な組み合わせ​

Serpro類似度は、serpro を含むフローまたは給与担保ローン専用のフローに表示されます：

idcheckserpro, idcheckserprodocs, idcheckserprodocssign, idunicoserprodocssign, creditoconsignado。

完全な対応マトリクスは利用可能なフローを参照してください。

このCapabilityを使用するユースケース​

creditoconsignado 内の動作​

creditoconsignado フローはSerproの返却値に基づいてジャーニーを分岐します：

  • Serpro 陽性 → 電子署名に直接進む。
  • Serpro 否定的（-1、または低類似度） → 顔照合のためにドキュメントを要求。
    • 顔照合 陽性 → 署名に進む。
    • 顔照合 否定的 → ジャーニーは署名なしで終了。

この条件分岐は、バックエンドでのオーケストレーションを必要とせず、フローの一部として組み込まれています。

最終更新 に