Serpro Similarity Return급여 담보 대출(INSS) 및 Serpro 데이터베이스와의 비교가 필요한 작업에 특화된 기능입니다. 촬영된 셀피와 Serpro에 등록된 사진 간의 유사도 점수를 반환합니다.
기능 설명
이 기능은 세션 셀피와 제공된 CPF에 연결된 Serpro 사진 간의 비교를 수행합니다. 비교가 가능한 경우 0~100 점수를 반환하며, Serpro가 얼굴을 찾지 못하거나 Serpro와의 연동이 실패하는 경우 특수 코드(-1, -2)를 반환합니다.
입력값
- Serpro Similarity가 포함된 플로우로
POST /v1/process를 통해 열린 캡처 세션. - 사용자의 CPF.
- Serpro 기능에 대한 테넌트 사전 활성화 (Unico 온보딩 팀과 협의 필요).
가능한 응답
| 응답 | 의미 |
|---|---|
| 점수 0–100 | Serpro가 얼굴을 찾은 경우. 점수가 높을수록 유사도가 높습니다. |
| 점수 -1 | Serpro가 CPF에 연결된 얼굴을 찾지 못함. |
| 점수 -2 | Serpro와의 연동 오류 — 점수를 가져올 수 없음. |
점수 -1과 -2는 낮은 점수가 아닙니다
이들은 서로 다른 시나리오에 대한 신호 코드입니다. 이를 0점으로 처리하면 잘못된 결정으로 이어집니다.
가용성
| 인터페이스 | 지원 여부 |
|---|---|
| SDK (Android, iOS, Flutter) | ✅ |
| Web (iFrame, Redirect) | ✅ |
| API (헤드리스, SDK 없음) | ✅ |
활성화 필요
지원되는 환경에서도 테넌트가 Serpro 기능에 대해 활성화되어 있어야 합니다. 해당 기능에 대한 접근 권한이 없는 경우 Unico 온보딩 팀에 문의하세요.
유효한 조합
Serpro Similarity는 serpro를 포함하거나 급여 담보 대출에 특화된 플로우에 나타납 니다:
idcheckserpro, idcheckserprodocs, idcheckserprodocssign, idunicoserprodocssign, creditoconsignado.
전체 매트릭스는 사용 가능한 플로우를 참조하세요.
이 기능을 사용하는 사용 사례
creditoconsignado 내 동작
creditoconsignado 플로우는 Serpro의 반환값에 따라 여정을 분기합니다:
- Serpro 긍정 → 전자 서명으로 바로 진행합니다.
- Serpro 부정(-1 또는 낮은 유사도) → 얼굴 매칭을 위한 문서 요청.
- 얼굴 매칭 긍정 → 서명으로 진행합니다.
- 얼굴 매칭 부정 → 여정이 서명 없이 종료됩니다.
이 조건부 동작은 플로우의 일부입니다 — 백엔드에서의 오케스트레이션이 필요하지 않습니다.