본인인증 API
본인인증 API
네이버 앱을 사용하여 이용자의 개인정보(이름, 생년월일, 휴대폰번호)로 개인의 본인 유무를 확인하는 네이버 본인인증 API 입니다. 개발하는 웹/앱 방식에 따라 네이버 앱으로 푸시(Push) 인증 메시지를 전송하여 인증하는 “푸시(Push) 인증”과 이용기관 앱에서 네이버 앱을 실행하여 네이버 인증 메시지 전송없이 비밀번호 입력만으로 인증하는 “앱투앱 인증” 방식 중 선택하여 연동할 수 있습니다.
1. RequestIdentity - 본인인증 요청
네이버 이용자에게 본인인증을 요청합니다.
function requestIdentity($ClientCode, $NaverIdentity)
Parameter
순번 | 변수명 | 타입 | 길이 | 필수 | 설명 |
---|---|---|---|---|---|
ClientCode | String | 12 | Y | 이용기관 코드 | |
NaverIdentity | NaverIdentity | - | Y | 본인인증 요청 정보 |
Return NaverIdentityReceipt Throws BarocertException
2. GetIdentityStatus - 본인인증 상태확인
본인인증 요청 후 반환받은 접수아이디로 본인인증 진행 상태를 확인합니다.
function getIdentityStatus($ClientCode, $ReceiptID)
Parameter
순번 | 변수명 | 타입 | 길이 | 필수 | 설명 |
---|---|---|---|---|---|
ClientCode | String | 12 | Y | 이용기관 코드 | |
ReceiptID | String | 32 | Y | 접수 아이디 |
Return NaverIdentityStatus Throws BarocertException
3. VerifyIdentity - 본인인증 검증
완료된 전자서명을 검증하고 전자서명값(signedData)을 반환 받습니다.
네이버 보안정책에 따라 검증 API는 1회만 호출할 수 있습니다. 재시도시 오류가 반환됩니다.
전자서명 만료일시 이후에 검증 API를 호출하면 오류가 반환됩니다.
function verifyIdentity($ClientCode, $ReceiptID)
Parameter
순번 | 변수명 | 타입 | 길이 | 필수 | 설명 |
---|---|---|---|---|---|
ClientCode | String | 12 | Y | 이용기관 코드 | |
ReceiptID | String | 32 | Y | 접수 아이디 |
Return NaverIdentityResult Throws BarocertException
4. 객체정보
4.1. BarocertException
순번 | 변수명 | 타입 | 길이 | 필수 | 설명 |
---|---|---|---|---|---|
Code | Integer | - | Y | API 처리에 대한 응답코드 | |
message | String | - | Y | API 처리에 대한 응답메시지 |