메인 콘텐츠로 건너뛰기
플랫폼이 공급자를 대신해 세금계산서를 발행하려면(대리 정발행, 간편 승인 역발행), 먼저 공급자의 공동인증서를 등록해야 합니다. 인증서 등록은 공급자가 직접 웹에서 인증서를 선택하고 비밀번호를 입력하는 과정이라, 발급받은 URL로 공급자를 보냈다가 등록이 끝나면 다시 플랫폼으로 돌아오게 해야 합니다. 이때 돌아올 위치가 인증서 등록 완료 리다이렉트 URL입니다.

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

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

​
등록 흐름

인증서 등록 URL 발급

인증서 등록 URL 조회 API를 호출하여 공급자가 인증서를 등록할 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 값입니다.
codemessage결과
0000인증서가 등록되었습니다.성공
0001다른 사업자등록번호로 발급된 인증서입니다.실패
0002세금계산서를 발행 할 수 없는 인증서입니다.실패
0003사업자용 인증서를 등록해주세요.실패
9999알 수 없는 오류실패
-1사용자 취소실패

​
주의사항

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

​
관련 문서