공동인증서 등록 Redirect 정책

고객의 공동인증서 등록은 볼타 웹 페이지에서 진행됩니다. 이에 따라 인증서 등록 결과에 대한 응답은 파트너사의 웹 페이지로 리다이렉트 해주는 구조로 전달됩니다.

공동인증서 등록 Redirect 설정

공동인증서 등록 결과에 따른 코드와 메시지는 아래와 같습니다.

코드	메시지	설명
`0000`	인증서가 등록되었습니다.	인증서가 성공적으로 등록되었을 때 응답입니다.
`0001`	다른 사업자등록번호로 발급된 인증서입니다.	고객의 사업자등록번호와 인증서 발행자의 사업자등록번호가 다를 때 응답입니다.
`0002`	세금계산서를 발행 할 수 없는 인증서입니다.	특수목적용 인증서, 사설 인증서를 등록을 시도하는 경우 응답입니다.
`0003`	사업자용 인증서를 등록해주세요.	사업자용 인증서가 아닌, 개인용 인증서를 등록하는 경우 발생합니다.
`9999`	알 수 없는 오류	볼타의 인증서 모듈 오류, API 서버 오류 등 이유로 발생합니다.
`-1`	사용자 취소	인증서 등록을 사용자가 취소한 경우 응답입니다.

Redirect URL은 테스트 환경과 라이브 환경 각각 별개로 등록하여야 합니다.

Redirect URL 설정은 개발자센터에서 할 수 있어요. (관련 가이드)

예시(성공)

예시(실패)

Redirect URL의 Query Parameter에는 code, message, customerKey가 고정적으로 포함됩니다.

Redirect URL로 전달된 응답이 볼타가 전달한 응답이 아닐 수 있으므로, 고객 조회 API를 이용하여 교차 검증 해주시기 바랍니다.