> ## Documentation Index
> Fetch the complete documentation index at: https://docs.bolta.io/llms.txt
> Use this file to discover all available pages before exploring further.

# 인증서 등록 연동

> 공급자의 공동인증서를 외부에서 등록받고, 리다이렉트 복귀 후 등록 결과를 확인하는 워크플로우입니다.

플랫폼이 공급자를 대신해 세금계산서를 발행하려면([대리 정발행](/docs/api-introduction/usecase-delegated), [간편 승인 역발행](/docs/api-introduction/usecase-reverse-simple)), 먼저 공급자의 공동인증서를 등록해야 합니다.

인증서 등록은 공급자가 직접 웹에서 인증서를 선택하고 비밀번호를 입력하는 과정이라, 발급받은 URL로 공급자를 보냈다가 등록이 끝나면 다시 플랫폼으로 돌아오게 해야 합니다. 이때 돌아올 위치가 **인증서 등록 완료 리다이렉트 URL**입니다.

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

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

자세한 설정 방법은 [API 키](/docs/developer-center/api-key)와 [웹훅 연결하기](/docs/developer-center/webhook-connection)를 참고하세요.

## 등록 흐름

<Steps>
  <Step title="인증서 등록 URL 발급" icon="code">
    [인증서 등록 URL 조회 API](/api-reference/인증서/공급자-공동인증서-등록-url-조회)를 호출하여 공급자가 인증서를 등록할 URL을 발급받습니다. 발급된 URL은 **5분간** 유효합니다.
  </Step>

  <Step title="공급자 인증서 등록" icon="user-check">
    공급자가 발급받은 URL에 접속해 인증서를 선택하고 비밀번호를 입력합니다. 이 단계는 공급자가 직접 수행합니다.
  </Step>

  <Step title="리다이렉트 복귀" icon="arrow-right-to-line">
    등록이 끝나면 공급자의 브라우저가 API 키에 설정한 리다이렉트 URL로 이동합니다.
  </Step>

  <Step title="등록 결과 확인" icon="circle-check">
    [인증서 등록 내역 조회 API](/api-reference/인증서/공급자-공동인증서-등록-내역-조회)를 호출해 응답의 `latestHistory.code`와 `latestHistory.message`로 등록 성공 여부를 확인합니다. 이 내역은 **등록 후 30초 이내**에만 조회할 수 있으므로, 리다이렉트로 복귀한 직후에 호출하세요.
  </Step>
</Steps>

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

## 등록 결과 코드

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

| code   | message                  | 결과 |
| ------ | ------------------------ | -- |
| `0000` | 인증서가 등록되었습니다.            | 성공 |
| `0001` | 다른 사업자등록번호로 발급된 인증서입니다.  | 실패 |
| `0002` | 세금계산서를 발행 할 수 없는 인증서입니다. | 실패 |
| `0003` | 사업자용 인증서를 등록해주세요.        | 실패 |
| `9999` | 알 수 없는 오류                | 실패 |
| `-1`   | 사용자 취소                   | 실패 |

## 주의사항

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

## 관련 문서

* [대리 정발행](/docs/api-introduction/usecase-delegated)
* [간편 승인 역발행](/docs/api-introduction/usecase-reverse-simple)
* [API 키](/docs/developer-center/api-key)
* [웹훅 연결하기](/docs/developer-center/webhook-connection)