...
신원 검증 API를 연동하는 개발자

신원 검증 API: 한 번의 REST 호출로 KYC 세션 생성

한 번의 POST로 검증 세션을 만들고, 고객을 Web SDK 위젯으로 보낸 뒤, 같은 세션에서 결과를 읽습니다. 신분증 확인, 얼굴 대조, 라이브니스가 그 안에서 실행되며, 모든 확인이 이름이 붙은 채 각자의 결과와 함께 돌아옵니다.

API 문서 읽기API 문서
  • REST API와 Web SDK REST + SDK
  • JWT와 영구 액세스 토큰 JWT · 토큰
  • 응답에 포함된 이름이 붙은 확인 이름이 붙은 확인
  • 공개 오류 레퍼런스 오류 레퍼런스

12,000건의 무료 검증을 첫 연결 시 제공

NeuroVision에 처음 연결하는 모든 기업에는 12,000건의 무료 검증이 12개월 동안 제공됩니다. 2026년 12월 1일부터 이용할 수 있습니다.

자세히 보기

독립 기관의 시험과 인증을 받았습니다

ISO register 글로벌 인증 마크ASIB 인증 마크QA Compliance Assessment 인증 마크
  • ISO/IEC 27001:2022
  • GDPR
  • iBeta ready
글로벌 커버리지

195개 이상의 국가 및 지역에서 발행된
16,000종 이상의 신분증

고객은 실제로 지닌 신분증으로 검증합니다. 90개 이상의 언어를 지원하며 손으로 쓴 항목과 MRZ도 판독합니다.

16,000+

신분증 종류


여권 신분증 운전면허증 체류 허가증 비자 취업 허가증 유권자증 납세자 식별번호 eID 전자여권 군인 신분증 건강보험증 국가 신분증 여행 증명서 난민 신분증 사회보장 카드
195+

국가 및 지역


카자흐스탄 아랍에미리트 독일 영국 싱가포르 인도 브라질 나이지리아 필리핀 베트남 튀르키예 멕시코 우즈베키스탄 이집트 인도네시아 프랑스 스페인 이탈리아 폴란드 케냐 사우디아라비아 일본 한국 호주 미국 캐나다 태국 말레이시아 남아프리카공화국
빠른 시작

다섯 단계로 첫 검증하기

  1. 01토큰 받기POST /user/login은 고객사 계정용 임시 JWT를 돌려줍니다.
  2. 02세션 만들기설정해 둔 시나리오를 지정해 POST /kyc/session/create를 호출합니다.
  3. 03위젯 열기링크나 QR 코드로 사용자를 Web SDK 위젯으로 보냅니다.
  4. 04결과 읽기세션 상태를 폴링하거나, 설정한 콜백을 받습니다.
  5. 05정식 운영 시작샌드박스에서 흐름을 테스트한 뒤 실제 사용자를 연결하십시오.
여기 있는 모든 것은 문서화되어 있습니다각 단계는 공개 API 레퍼런스의 메서드와 같은 이름으로 대응합니다.
이용 방법
엔드포인트

신원 검증 API가 다루는 범위

다섯 가지 메서드 그룹과, 이를 사용하는 위젯.

아래 이름은 당사의 공개 레퍼런스에 있는 이름입니다. 랜딩 페이지에서 무엇이라고 불렀는지 짐작하지 않고도 각 메서드를 찾을 수 있습니다.

KYC 세션

세션을 만들고, 상태를 확인하고, 목록을 조회하고, 필터링하고, 로그 아카이브를 내려받습니다.

메서드 8개

액세스 토큰

영구 토큰을 만들고, 사용자가 가진 토큰을 조회하고, 하나를 수정하거나 삭제합니다.

메서드 4개

사용자와 잔액

사용자를 인증해 임시 JWT를 받고, 그룹 잔액을 읽거나 갱신합니다.

메서드 3개

인물

인물 명단과 인물 레코드를 만들고, 수정하고, 삭제하고, 저장된 얼굴에 이미지를 추가합니다.

메서드 8개

데이터 출처

소스와 소스 그룹을 만들고, 조회하고, 수정하고, 삭제합니다.

메서드 8개

Web SDK

위젯을 설치하고, 파라미터를 전달하고, 위젯을 세션에 묶는 클라이언트 키를 다룹니다.

4페이지
개발자

한 번의 요청으로 API 호출

세션은 한 번의 POST로 만들어집니다. 이후는 위젯이 이어받고, 결과가 준비되면 고객사 백엔드가 읽습니다.

터미널REST API
curl -X POST $NV_API_URL/kyc/session/create \  -H "Content-Type: application/json" \  -H "Authorization: Bearer $JWT" \  -d '{"token":"$JWT","schemaId":"schema-001"}'예시일 뿐입니다. 전체 요청 본문은 문서를 참고하십시오.
오류{ "status": …, "message": "…", "details": … }
신뢰와 데이터

데이터가 있는 곳, 머무는 곳

당사의 클라우드에서, 또는 고객사의 보안 경계 안에서 확인을 실행하십시오.

ISO/IEC 27001:2022인증받은 보안 체계
  • 모든 호출에 JWT
  • 영구 액세스 토큰
  • 온프레미스 구축
  • 이미지 보관 기간은 고객사가 설정
Web SDK

사용자가 실제로 보는 Web SDK 위젯

위젯은 고객사 페이지 위에서 실행되며, 고객을 신분증 촬영, 셀피, 각종 확인으로 안내한 뒤 결과를 고객사로 보냅니다.

고객이 쓰는 브라우저에서 작동

데스크톱과 모바일의 모든 최신 브라우저에서 작동하며 iOS와 Android도 포함합니다. 위젯이 요청하는 권한은 카메라 접근뿐입니다.

앱 다운로드 불필요

키로 세션에 연결

클라이언트 키가 고객사 페이지의 위젯을 만들어 둔 세션과 연결합니다. 이렇게 결과가 고객사로 돌아옵니다.

링크 또는 QR 코드로 시작

사용자는 시작 화면을 열어 QR 코드를 스캔하거나 링크를 따라가며, 시작하기 전에 인터페이스 언어를 바꿀 수 있습니다.

실행할 단계는 고객사가 정합니다

신분증, 신분증을 든 셀피, 라이브니스, 위변조 탐지 단계는 위젯 코드가 아니라 고객사의 시나리오에서 켜고 끕니다.

Web SDK 위젯: 시작 화면, 신분증 촬영, 결과

위젯은 설치부터 클라이언트 키까지 네 페이지로 문서화되어 있습니다.

결과

세션 결과 읽기

받는 방법은 두 가지, 읽는 형식은 하나.

각 확인은 고유한 상태와 신뢰도 값을 가진 이름이 붙은 항목으로 돌아옵니다. 그래서 고객사의 규칙은 하나의 판정이 아니라 필요한 부분을 읽을 수 있습니다.

세션 상태 폴링

세션 id나 클라이언트 키로 세션을 조회해 현재 상태와 결과를 읽습니다.

풀

콜백 받기

세션이 끝나면 콜백이 최종 결과를 전달하므로 폴링할 필요가 없습니다.

푸시

신뢰도가 붙은 이름이 있는 확인

신분증 확인과 얼굴 확인은 이름이 붙은 항목으로 돌아오며, 각각 상태와 신뢰도 값이 있습니다.

JSON

모든 오류에는 코드가 있습니다

실패한 확인은 당사의 공개 레퍼런스에 있는 코드와 설명을 돌려주므로, 지원 담당자가 고객에게 어떻게 해야 하는지 안내할 수 있습니다.

코드 40개
접근

토큰, 접근, 오류

임시 토큰과 영구 토큰

로그인하면 고객사가 정한 유효 기간의 임시 JWT가 돌아옵니다. 서버 간 작업에는 영구 액세스 토큰을 만들고, 더는 필요 없으면 폐기합니다.

대응할 수 있는 오류

문서화된 40개의 코드에는 각각 설명이 있으며, 이미지 품질, 신분증 문제, 사기 신호, 얼굴 확인을 아우릅니다. 그래서 거절 사유를 고객에게 설명할 수 있습니다.

오류 레퍼런스 보기

내려받을 수 있는 세션 로그

세션은 API로 로그 아카이브로 내보낼 수 있으므로, 감사나 분쟁에는 스크린샷이 아니라 고객사가 가진 사본으로 대응합니다.

API 문서 읽기

여기 있는 모든 메서드는 레퍼런스에 있습니다

이 페이지의 모든 엔드포인트, 필드, 오류 코드는 당사의 공개 문서에 같은 이름으로 나와 있으므로, 예시에서 바로 그것을 설명하는 레퍼런스 페이지로 이동할 수 있습니다.

선택 이유

많은 팀이 NeuroVision Global Systems를 선택하는 이유

검증 가능한 정확도

독립 기관의 평가를 받은 얼굴 대조, 모든 결과에 신뢰도 점수가 제공됩니다.

검증 가능한 정확도

얼굴 알고리즘은 NIST의 시험을 거쳐 TOP-24, NIST FRVT 1:1 Verification에 올랐습니다. 모든 신분증·얼굴 결과에는 신뢰도 점수가 함께 제공됩니다.

TOP-24NIST FRVT 1:1 Verification
0.1초얼굴 대조 1건당

한 시간 이내 서비스 시작

REST API, Web SDK, iOS·Android SDK, WebView를 지원하며 샌드박스부터 시작합니다.

한 시간 이내 서비스 시작

샌드박스 키가 있으면 REST API나 Web SDK 연동은 한 시간 이내에 끝나며, 운영 환경 적용은 영업일 하루면 됩니다. 실제 트래픽으로 진행하는 14일 무료 체험에는 전체 지원이 포함됩니다.

1시간 미만샌드박스 키로 연동하기까지
14일API 전체 기능을 쓸 수 있는 체험

글로벌 커버리지

195개 이상의 국가 및 지역, 16,000종 이상의 신분증, 90개 이상의 언어를 지원합니다.

글로벌 커버리지

고객은 실제로 지니고 있는 신분증으로 검증합니다. 195개 이상의 국가 및 지역에서 발행된 16,000종 이상의 신분증을 지원하며, 손으로 쓴 항목과 MRZ도 판독합니다.

16,000+신분증 종류
90+언어

실제 공격을 바탕으로 만든 위변조 탐지

40가지 이상의 신분증 검증, 1:N 얼굴 검색, 차단 명단 스크리닝에 30개 계층을 더했습니다.

실제 공격을 바탕으로 만든 위변조 탐지

신분증 검증에 더해 딥페이크에 견디는 라이브니스, 1:N 중복 제거, 차단 명단 스크리닝을 갖췄습니다. 한 사람당 한 계정입니다.

40+신분증 검증
0.01%잔여 사기 위험

설계 단계부터 반영된 개인정보 보호

ISO/IEC 27001:2022 인증과 GDPR 대응을 갖추고 온프레미스, 클라우드, 하이브리드로 제공합니다.

설계 단계부터 반영된 개인정보 보호

NeuroVision 클라우드, 고객사의 데이터센터, 또는 하이브리드로 운영할 수 있으며, 템플릿과 개인정보는 해당 법역을 벗어나지 않습니다.

27001:2022ISO/IEC 인증
GDPR대응

모든 엔진을 자체 개발

OCR, 얼굴, 라이브니스, 위변조 탐지가 모두 자체 기술입니다.

모든 엔진을 자체 개발

한 곳의 공급사가 하나의 API로 KYC, KYB, AML, KYT를 모두 제공합니다. SLA도 하나, 외부 라이선스도 없습니다.

20년컴퓨터 비전 개발
SLA 1개모든 검증에 적용
요금

신원 검증 API 요금

API는 별도의 라이선스가 있는 독립 제품이 아닙니다. 완료된 확인에 대해서만 비용을 냅니다.

신분증 패키지

최저 $0.25 건당

신분증 인식과 위변조 탐지. 셀피와 라이브니스는 Basic 패키지로 추가합니다. 계산기에서 고객사에 맞는 구성을 만드십시오.

요금 계산하기

사용한 만큼 지불

API에는 구독료도 라이선스 비용도 없습니다. 완료된 확인에 대해서만 비용을 냅니다.

요금 보기

무료 체험

API 전체 기능과 첫날부터 제공되는 샌드박스를 갖춘 실제 트래픽 기반 14일 체험.

대량 이용 및 엔터프라이즈

대량 이용을 위한 맞춤 조건, 온프레미스 구축, SLA.

제품

AI 기반 신원확인 솔루션

고객을 검증하고 인증하고 보호하는 데 필요한 모든 것을 하나의 강력한 플랫폼에서 제공합니다.

실제 사람과 실제 신분증을 몇 초 만에 검증합니다. 신분증 촬영, 얼굴 대조, 라이브니스, 위변조 탐지, AML까지 제공합니다.

자세히 보기

모든 고객을 제재 명단, PEP, 감시 명단, 자기 제한 명단과 대조합니다. 같은 검증 흐름 안에서 처리됩니다.

자세히 보기

계좌 뒤에 있는 기업을 검증합니다. 기업 등기 정보와 최종 실제 소유자(UBO)를 온보딩 전에 확인합니다.

자세히 보기

실시간 거래 모니터링: 의심스러운 이체를 검토 대상으로 표시하며, KYC·AML과 같은 API로 제공됩니다.

자세히 보기

실제로 그 자리에 있는 사람인지 확인하며 딥페이크에도 견딥니다. 재방문 고객을 비밀번호 대신 얼굴로 인증할 수 있습니다.

자세히 보기

결제 시 얼굴 또는 신분증으로 결제를 확인합니다. 고객이 이미 검증을 마친 신원을 그대로 사용합니다.

자세히 보기
연락처

API 키 받기

무엇을 만들고 있는지, 어떤 확인이 필요한지 알려 주십시오. 샌드박스 자격 증명을 보내 드리고, 정식 운영까지 도울 엔지니어를 연결해 드리겠습니다.

직접 연락하고 싶으십니까?
이름 *
올바른 이름을 입력해 주십시오
회사명
이메일 *
올바른 이메일 주소를 입력해 주십시오
전화번호
올바른 전화번호를 입력해 주십시오
문의 내용 (선택)
개인정보 처리방침에 동의해 주십시오
FAQ

신원 검증 API FAQ

개발자가 시작하기 전에 자주 묻는 질문입니다. 전체 레퍼런스는 문서에 있으며 링크를 걸어 두었습니다.

원하는 답을 찾지 못하셨습니까?

로그인하면 임시 JWT가 돌아오며, 서버 간 호출을 위한 영구 액세스 토큰도 만들 수 있습니다. 둘 다 API 레퍼런스에 설명되어 있습니다.

네. 세션의 최종 결과에 대해 지원합니다. 세션 id나 클라이언트 키로 세션 상태를 폴링할 수도 있습니다.

연령 확인은 같은 세션에서 실행됩니다. 연령 확인 API를 참고하십시오.

요청 한도는 공개하지 않습니다. 계획하고 있는 물량을 알려 주시면 해당 경우에 맞춰 확인해 드리겠습니다.

상태가 붙은 이름이 있는 확인과 함께, 당사의 공개 오류 레퍼런스에 있는 오류 코드와 설명이 돌아옵니다. 지원 팀이 고객에게 다음에 무엇을 해야 하는지 안내하기에 충분합니다.

AML 스크리닝도 같은 방식으로 이름이 붙은 검증 항목으로 반환됩니다. 자세한 내용은 AML API를 참고하십시오.

네. 실제 데이터를 연결하기 전에 샌드박스에서 연동을 테스트하며, 첫 세션까지 연동 담당자가 도와 드립니다.

별도의 API 라이선스는 없습니다. 완료된 확인에 대해서만 비용을 내며, 위변조 탐지가 포함된 신분증 인식은 $0.25부터입니다. 고객사에 맞는 구성은 요금 페이지에서 만들 수 있습니다.

즉시 KYC 검증을 지원하는
올인원 얼굴인식 플랫폼

온보딩을 간소화하고 사기를 막으며 KYC/AML 규정을 지키십시오