포털에서
KYC 포털이 보여 주어야 할 모든 것을 한곳에서.
고객 포털은 팀이 매일 사용하는 공간입니다. API 호출의 원시 로그가 아니라, 사용량, 키, 결제, 결과를 사람이 읽기 쉽게 정리해 보여 드립니다.
요금제 및 구독
API 키
사용량 내역
결제 및 청구서
브랜딩(해당 요금제에서 제공)
Sign-in
KYC 포털답게 철저히 보호됩니다.
이 포털은 컴플라이언스 책임자가 로그인하는 곳이므로, 로그인 자체에도 그 뒤의 검증과 같은 수준의 정성을 들였습니다.
- 비밀번호는 해시 처리되며 평문으로 저장되지 않습니다.
- 로그인에 8번 실패하면 계정이 15분간 잠기므로 무작위 대입 스크립트는 소용이 없습니다.
- 세션은 무작위 토큰이며 서버에는 해시만 보관되고, 쿠키에는 HttpOnly가 설정됩니다.
- 2단계 로그인 — 출시 예정입니다.
- 로그인 화면과 포털 전체를 영어와 프랑스어로 사용할 수 있습니다.
API 키
구분하기 쉬운 키, 티켓 없이 바로 폐기할 수 있습니다.
키는 포털에서만 생성되며 익명 API 호출로는 만들 수 없고, 모든 키는 해당 계정에만 적용됩니다.
- Sandbox 키와 라이브 키는 항상 구분되므로 테스트 스크립트가 실수로 운영 환경에 영향을 줄 수 없습니다.
- 전체 키는 생성 직후 한 번만 표시됩니다. 그 이후에는 짧은 접두어만 평문으로 보관합니다.
- 키를 폐기하면 즉시 적용되어, 그 키로 보내는 다음 요청부터 거부됩니다.
- 키별 요청 한도는 모든 요금제에 포함되어 있습니다.
API 키
샘플 데이터새 sandbox 키가 생성되었습니다
vk_sand_8Kd93jXQmZp2AeBTUqk7RmS4
지금 복사해 두세요. 다시 표시되지 않으며, 이후에는 접두사만 보입니다.
Sandbox 기본값
vk_sand_8Kd9…
Sandbox2026년 9월 12일활성프로덕션
vk_live_2Qf1…
라이브2026년 8월 3일활성이전 연동 테스트
vk_sand_9Ta2…
Sandbox2026년 2월 18일해지됨
샘플 데이터
결과는 이렇게 보입니다.
모든 인증은 하나의 불투명한 점수가 아니라 이름이 붙은 개별 판정으로 반환됩니다. 아래는 가상의 샘플로, 이름과 문서는 지어낸 것이지만 결과의 형태는 실제와 같습니다.
Jordan Reyes
Ontario driver's licence
- 문서
- 통과
- 신분증이 진본으로 확인되었습니다. 앞면, 뒷면, 바코드, 그리고 있는 경우 MRZ까지 모두 읽혔습니다.
- 신원
- 통과
- 바코드, MRZ, 인쇄된 면의 모든 필드가 서로 일치합니다. 일치하지 않는 소스는 평균을 내지 않고 표시됩니다.
- 이름 일치
- 통과
- 연동 시스템에서 예상한 이름이 신분증의 이름과 일치합니다.
- 라이브니스
- 통과
- 안내에 따라 수행하는 챌린지로, 최소 10프레임에 걸쳐 478개의 얼굴 랜드마크를 추적합니다.
- Anti-spoof
- 통과
- 사진을 다시 찍은 사진, 화면 재생, 인쇄된 얼굴이 아닙니다.
- 딥페이크
- 통과
- 합성되었거나 조작된 얼굴의 흔적이 없습니다.
- 마스크
- 통과
- 3D 마스크나 보형물의 흔적이 없습니다.
- 변조
- 탐지됨
- 문서 이미지에 대한 참고용 신호이며, 합격/불합격을 가르는 기준이 아닙니다.
- 얼굴 대조
- 통과
- 실시간 얼굴이 문서의 초상과 일치하는지를 고정된 판정 기준선에 따라 보고합니다. 퍼센트 수치는 표시하지 않습니다.
- 제재
- Add-on
- 이 기능을 추가한 계정에 대해 OFAC, UN, EU, Canada OSFI, UK HMT, Australia DFAT, OpenSanctions 목록을 조회합니다. 목록 업데이트는 수동으로 또는 외부에서 예약한 동기화로 실행되며, 매일 자동으로 갱신되지는 않습니다.
- 주소
- 통과
- 비교할 주소가 제공된 경우, 등록된 주소가 신분증에 인쇄되었거나 인코딩된 주소와 일치합니다.
결과의 구성 살펴보기
인증 결과 샘플을 필드별로 살펴봅니다.
샘플 데이터: 가상의 신청자에 대한 가상의 세션이며, 대시보드와 웹훅 수신기에 도착하는 형태 그대로 보여 드립니다.
- 세션 ID
- ses_7f2a91c0b3d4 — 세션을 만들 때 사용한 id로, 이후 모든 조회와 웹훅에서도 이 id를 사용합니다.
- 상태
- VERIFIED, FAILED, PENDING, IN_PROGRESS 또는 EXPIRED.
- 환경
- Sandbox 또는 프로덕션 환경이 세션에 기록되며, 서로 섞이지 않습니다.
- 신청자
- 신분증에서 읽어 낸 이름, 생년월일, 문서 유형, 문서 발급 국가 및 관할 지역, 주소입니다.
- 검사별 판정
- 문서, 라이브니스, 스푸핑 방지, 얼굴 일치, 그리고 활성화된 경우 제재 대상 검사까지, 각각 PASS, FAIL 또는 SKIPPED로 개별 표시됩니다.
- 얼굴 대조
- 고정된 판정 기준과 비교합니다. 백분율이 아닌 통과 또는 실패로만 알려 드립니다.
- 재촬영 안내
- 실패 시 막연한 "다시 시도" 대신, 문서와 셀카 중 어느 쪽을 다시 촬영해야 하는지 알려 드립니다.
- 완료 시각
- 세션이 최종 상태에 도달한 시점입니다.
- 전달 방식
- 서명된 웹훅이 webhook_url로 전송되며, 같은 결과를 대시보드와 API에서도 확인할 수 있습니다.
이 결과에 사용된 이미지는 짧은 타이머에 따라 자동으로 삭제되며, 기본값은 7일입니다. 결과 자체는 그대로 유지됩니다.
나머지 이야기
관리자 기능, 역할, 한도에 대해 솔직하게 안내해 드립니다.
직접 찾아보시게 두지 않고 분명하게 말씀드리고 싶은 두 가지가 있습니다.
관리자 기능
모든 고객 포털 뒤에는 저희 팀이 사용하는 별도의 내부 콘솔이 있습니다. 모든 계정의 사용량과 청구 내역을 한 번에 검색하고, 요금제를 변경하며, 검증된 고정 범위 안에서 공용 탐지 설정을 조정합니다. 고객님의 계정에 포함되지 않으며 화면에 표시되지도 않습니다.
역할과 한도
현재는 계정당 로그인 하나만 제공됩니다. 관리자, 청구, 읽기 전용 등 각자의 역할로 팀원을 초대하는 기능은 곧 제공될 예정입니다. 키별 요청 한도는 모든 요금제에 포함되어 있으며, 라이브 API에서의 적용은 곧 제공될 예정입니다. 따라서 현재는 요금제의 한도를 API가 강제하는 제한이 아니라 설계 시 기준으로 삼아 주세요.
계정 만들기
포털에서 가입하고 영어 또는 프랑스어를 선택하세요. sandbox는 카드 등록이 필요 없습니다.sandbox 키 복사하기
키를 만든 직후 한 번만 표시됩니다. 소스 관리가 아닌 환경 변수에 보관해 주세요.세션 만들기
리턴 URL과 웹훅 URL을 담아 API를 한 번 호출합니다. 반환된 링크를 신청자에게 보내 주세요.결과 확인하기
대시보드에 결과가 도착하는 모습을 지켜보시거나, 결과가 나오는 즉시 서명된 웹훅으로 받아 보세요.
대부분의 팀은 당일 오후에 sandbox 연동을 완료합니다.
문의
대시보드에 대한 솔직한 답변
시작하기
직접 로그인해서 확인해 보세요.
대시보드를 가장 빠르게 이해하는 방법은 직접 열어 보는 것입니다. sandbox 키를 만들고, 인증을 실행하고, 결과가 도착하는 모습을 확인해 보세요.