Skip to main content
세금계산서 발행에 사용할 공동인증서 소유자를 발급자 등록 API로 등록한 뒤 인증서를 등록하세요. 일반 발행과 대리 정발행에서는 공급자가 발급자이고, 위수탁 발행에서는 수탁자가 발급자입니다. 인증서 등록은 발급자가 직접 웹에서 인증서를 선택하고 비밀번호를 입력하는 과정입니다. 발급자를 등록 URL로 보낸 뒤 등록이 끝나면 플랫폼으로 돌아오게 하세요. 이때 돌아올 위치가 인증서 등록 완료 리다이렉트 URL입니다.

​
사전 준비: 리다이렉트 URL 설정

리다이렉트 URL은 API 키 단위로 설정합니다. 별도로 지정하지 않으면 기본값 https://bolta.io/openapi-certificate-redirect이 사용되며, 개발자센터의 API 키 수정 화면에서 원하는 주소로 변경할 수 있어요. 자세한 설정 방법은 API 키와 웹훅 연결하기를 참고하세요.

​
등록 흐름

인증서 등록 URL 발급

인증서 등록 URL 조회 API의 경로에 issuerId를 넣어 등록 URL을 발급받습니다. 발급된 URL은 5분간 유효합니다.

발급자 인증서 등록

발급자가 URL에 접속해 인증서를 선택하고 비밀번호를 입력합니다.

리다이렉트 복귀

등록이 끝나면 발급자의 브라우저가 API 키에 설정한 리다이렉트 URL로 이동합니다.

등록 결과 확인

인증서 등록 내역 조회 API를 호출해 응답의 latestHistory.code와 latestHistory.message로 등록 성공 여부를 확인합니다. 이 내역은 등록 후 30초 이내에만 조회할 수 있으므로, 리다이렉트로 복귀한 직후에 호출하세요.
리다이렉트는 브라우저 이동일 뿐이므로, 등록이 실제로 성공했는지는 인증서 등록 내역 조회 API의 결과 코드로 판단합니다. 응답의 latestHistory가 있으면 latestHistory.code와 latestHistory.message로 성공 여부를 확인하고, latestHistory가 null이면 조회 가능한 등록 내역이 없는 상태로 처리하세요.

​
등록 결과 코드

인증서 등록 내역 조회 API 응답의 latestHistory.code와 latestHistory.message 값입니다.

​
주의사항

  • 인증서 등록 URL은 발급 후 5분이 지나면 만료됩니다. 만료되면 다시 발급받아야 합니다.
  • 인증서 등록 내역은 등록 후 30초 동안만 조회할 수 있습니다. 리다이렉트 복귀 직후에 조회하세요.
  • 리다이렉트 URL은 직접 운영하는 HTTPS 엔드포인트로 지정하는 것을 권장합니다.

​
관련 문서