전자서명(복수) API

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

1. RequestMultiSign - 전자서명(복수) 요청

  • 네이버 이용자에게 복수(최대 50건) 문서의 전자서명을 요청합니다.

function requestMultiSign($ClientCode, $NaverMultiSign)

Parameter

순번 변수명 타입 길이 필수 설명
ClientCode String 12 Y 이용기관 코드
NaverMultiSign NaverMultiSign - Y 전자서명 요청 정보

Return NaverMultiSignReceipt Throws BarocertException

2. GetMultiSignStatus - 전자서명(복수) 상태확인

  • 전자서명(복수) 요청 후 반환받은 접수아이디로 인증 진행 상태를 확인합니다.

function getMultiSignStatus($ClientCode, $ReceiptID)

Parameter

순번 변수명 타입 길이 필수 설명
ClientCode String 12 Y 이용기관 코드
ReceiptID String 32 Y 접수 아이디

Return NaverMultiSignStatus Throws BarocertException

3. VerifyMultiSign - 전자서명(복수) 검증

  • 완료된 전자서명을 검증하고 전자서명값(signedData)을 반환 받습니다.

  • 네이버 보안정책에 따라 검증 API는 1회만 호출할 수 있습니다. 재시도시 오류가 반환됩니다.

  • 전자서명 만료일시 이후에 검증 API를 호출하면 오류가 반환됩니다.

function verifyMultiSign($ClientCode, $ReceiptID)

Parameter

순번 변수명 타입 길이 필수 설명
ClientCode String 12 Y 이용기관 코드
ReceiptID String 32 Y 접수 아이디

Return NaverMultiSignResult Throws BarocertException

4. 객체정보

4.1. BarocertException

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