본인인증 API

네이버 앱을 사용하여 이용자의 개인정보(이름, 생년월일, 전화번호)로 개인의 본인 유무를 확인하는 네이버 본인인증 API 입니다. 개발하는 웹/앱 방식에 따라 네이버 앱으로 푸시(Push) 인증 메시지를 전송하여 인증하는 “푸시(Push) 인증”과 이용기관 앱에서 네이버 앱을 실행하여 네이버 인증 메시지 전송없이 비밀번호 입력만으로 인증하는 “앱투앱 인증” 방식 중 선택하여 연동할 수 있습니다.

1. RequestIdentity - 본인인증 요청

네이버 이용자에게 본인인증을 요청합니다.

naverService.requestIdentity(ClientCode, Identity, success, error)

Parameter

변수명	타입	길이	필수	설명
ClientCode	String	12	Y	이용기관 코드
Identity	Identity	-	Y	본인인증 요청 정보
success	function	-	Y	성공에 대한 콜백 함수
error	function	-	Y	실패에 대한 콜백 함수

Return IdentityReceipt Throws BarocertException

2. GetIdentityStatus - 본인인증 상태확인

본인인증 요청 후 반환받은 접수아이디로 본인인증 진행 상태를 확인합니다.

naverService.getIdentityStatus(ClientCode, ReceiptID, success, error)

Parameter

변수명	타입	길이	필수	설명
ClientCode	String	12	Y	이용기관 코드
ReceiptID	String	32	Y	접수 아이디
success	function	-	Y	성공에 대한 콜백 함수
error	function	-	Y	실패에 대한 콜백 함수

Return IdentityStatus Throws BarocertException

3. VerifyIdentity - 본인인증 검증

완료된 전자서명을 검증하고 전자서명값(signedData)을 반환 받습니다.
네이버 보안정책에 따라 검증 API는 1회만 호출할 수 있습니다. 재시도시 오류가 반환됩니다.
전자서명 만료일시 이후에 검증 API를 호출하면 오류가 반환됩니다.

naverService.VerifyIdentity(ClientCode, ReceiptID, success, error)

Parameter

변수명	타입	길이	필수	설명
ClientCode	String	12	Y	이용기관 코드
ReceiptID	String	32	Y	접수 아이디
success	function	-	Y	성공에 대한 콜백 함수
error	function	-	Y	실패에 대한 콜백 함수

Return IdentityResult Throws BarocertException

4. 객체정보

4.1. BarocertException

순번	변수명	타입	길이	설명
	Code	Number	-	API 처리에 대한 응답코드
	message	String	-	API 처리에 대한 응답메시지

4.2. Identity

변수명	타입	길이	필수	설명
receiverHP	String	11	Y	수신자 휴대폰번호 → 하이픈(-) 제외하고 입력
receiverName	String	80	Y	수신자 성명
receiverBirthday	String	8	Y	수신자 생년월일 → 형식: yyyyMMdd
callCenterNum	String	12	Y	고객센터 연락처
expireIn	Number	4	Y	요청 만료시간 → 최대: 1000초(s) / 권장: 300초(s)
appUseYN	Boolean	-	N	앱투앱 인증 방식 이용 여부 └True앱투앱 인증 └False채널 메시지 인증 : 기본값
deviceOSType	String	7	조건부	모바일장비 운영체제 └ANDROID └IOS appUseYN=True 경우 필수
returnURL	String	1000	조건부	복귀 URL → 앱투앱 인증 이용시 호출할 URL 또는 앱스킴 appUseYN=True 경우 필수

4.3. IdentityReceipt

변수명	타입	길이	필수	설명
receiptID	String	32	Y	접수아이디
scheme	String	-	N	앱스킴 appUseYN=True 경우 반환
marketUrl	String	-	N	앱 다운로드 URL appUseYN=True 경우 반환

4.4. IdentityStatus

변수명	타입	길이	필수	설명
receiptID	String	32	Y	접수아이디
clientCode	String	12	Y	이용기관 코드
state	Number	1	Y	상태 └0대기 └1완료 └2만료
expireIn	Number	4	Y	요청 만료시간 → 최대: 1000초(s)
callCenterName	String	200	Y	이용기관명
callCenterNum	String	11	Y	이용기관 연락처
expireDT	String	14	Y	전자서명 만료일시 → 형식: yyyyMMddHHmmss
appUseYN	Boolean	-	Y	앱투앱 인증 방식 이용 여부 └True앱투앱 인증 └False채널 메시지 인증
deviceOSType	String	7	N	모바일장비 운영체제 └ANDROID └IOS appUseYN=True 경우 반환
scheme	String	-	N	앱스킴 appUseYN=True 경우 반환
returnURL	String	1000	N	복귀 URL → 앱투앱 인증 이용 호출할 URL 또는 앱스킴 appUseYN=True 경우 반환

4.5. IdentityResult

변수명	타입	길이	필수	설명
receiptID	String	32	Y	접수아이디
state	Number	1	Y	상태 └0대기 └1완료 └2만료
receiverName	String	80	N	AES 암호화 수신자 성명
receiverYear	String	4	N	AES 암호화 수신자 출생년도 → 형식 : yyyy
receiverDay	String	4	N	AES 암호화 수신자 출생월일 → 형식 : MMdd
receiverHP	String	11	N	AES 암호화 수신자 휴대폰번호
receiverGender	String	1	N	AES 암호화 수신자 성별 └M남성 └F여성
ReceiverEmail	String	-	N	AES 암호화 수신자 이메일
receiverForeign	string	1	N	AES 암호화 외국인 여부 └Y외국인 └N내국인
signedData	String	-	Y	전자서명값
ci	String	-	N	AES 암호화 CI