국가 신분증 연계 확인 증명서(파생 VC)

Derived identity-verification credential — the app verifies the holder against a national ID, then issues a credential that carries only the fact of that verification.

사용자가 국가가 발급한 신분증으로 앱 안에서 본인확인을 마치면, SuperWallet은 "확인했다는 사실"만 담은 증명서를 발급합니다. 이 증명서를 파생 증명서(derived VC)라고 부릅니다 — 원본 자격증명에서 필요한 사실 하나만 뽑아 새로 발급한 증명서라는 뜻입니다.

핵심: 기관은 사용자의 신분증 번호나 사본을 받지 않고도 "이 사람은 국가 신분증으로 본인확인이 끝난 사람"이라는 사실만 확인할 수 있습니다. 원본 신원값은 증명서에 담기지 않으며, 확인 절차가 끝난 뒤 보관하지 않습니다.

어떻게 동작하나

  1. 사용자가 앱에서 국가 신분증으로 본인확인을 진행합니다(원천은 아래 표 참고).
  2. 확인이 성공하면 확인 사실(확인 여부, 확인 방식, 확인 시각)만 남기고 증명서를 발급합니다.
  3. 사용자가 그 증명서를 기관에 제시하거나, 점수 조회 동의에 함께 담아 신뢰 수준을 전달합니다.

증명서에 담기는 것 / 담기지 않는 것

담기는 것담기지 않는 것
  • 본인확인 완료 여부
  • 확인에 사용된 방식(문서 확인 · 제휴 금융기관 확인 · 국가 전자신분 등)
  • 확인 시각
  • 발급기관 서명
  • 신분증 번호(주민등록번호·여권번호 등)
  • 신분증 이미지·스캔본
  • 주소·생년월일 등 기재사항 원본
  • 기관끼리 대조 가능한 공통 식별자
이 API 표면의 주체 식별자는 언제나 파트너 전용 익명 ID(pairwiseSub)입니다. 파생 증명서를 도입해도 이 원칙은 바뀌지 않습니다 — 기관마다 값이 달라 기관끼리 사용자를 맞춰볼 수 없습니다. 자세한 내용은 동의 모델을 참고하세요.

지원 원천과 도입 상태

본인확인의 원천은 여러 가지이며, 각각 도입 상태가 다릅니다. 아래 표는 현재 상태를 그대로 적은 것입니다 — "준비 중"은 아직 사용할 수 없다는 뜻입니다.

원천상태설명
문서 확인(OCR) 운영 중 앱에서 신분증·여권 등을 촬영하면 문서 판독으로 기재사항을 확인합니다. 현재 KYC 문서 확인에 사용 중인 방식입니다.
제휴 금융기관 확인 단계적 도입 이미 대면 실명확인을 마친 제휴 금융기관의 확인 결과를 연계합니다. 제휴 범위에 따라 순차 적용됩니다.
한국 모바일 주민등록증 준비 중 행정안전부 모바일 신분증 체계와의 연계. 적용 시점은 기관 연동 일정에 따릅니다.
베트남 VNeID 준비 중 베트남 국가 전자신분(VNeID) 연계. 적용 시점은 기관 연동 일정에 따릅니다.
라오스 LAeID 준비 중 라오스 국가 전자신분(LAeID) 연계. 적용 시점은 기관 연동 일정에 따릅니다.
원천이 무엇이든 기관이 받는 것은 동일한 형태의 확인 사실입니다. 원천이 늘어나도 기관 쪽 연동 방식은 바뀌지 않고, 확인 방식 값이 추가될 뿐입니다.

점수 응답의 identityAssurance 필드 (예고)

아직 제공되지 않습니다. identityAssurance는 현재 /fi/score/query·/fi/decision/evaluate 응답에 포함되어 있지 않습니다. 지금 이 필드를 전제로 연동을 구현하지 마세요. 아래는 방향을 미리 알리기 위한 예고이며 확정 스키마가 아닙니다.

파생 증명서가 준비되면, 기관이 점수를 조회할 때 그 점수의 주체가 어느 수준으로 본인확인된 사람인지를 함께 전달할 계획입니다. 형태는 아래와 같은 블록을 예상하고 있습니다(예시 — 확정 아님).

{
  "pairwiseSub": "b41c9d2f-8e77-4a10-9c3e-example",
  "score": 712,
  "tier": "GOOD",

  "identityAssurance": {
    "verified": true,
    "method": "DOCUMENT",
    "verifiedAt": "2026-08-01 09:12:00"
  }
}

제공 여부와 조건은 동의 모델의 데이터 카테고리 체계를 따르며, 확정되면 API 레퍼런스와 openapi.json에 정식 반영하고 별도로 공지합니다.

지금 해두면 좋은 것