> ## 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.

# 연동 관리

> 개발자센터에서 연동을 추가하고 연동 개요와 설정을 확인합니다.

## 연동과 환경 선택

연동은 볼타 API를 사용하는 시스템 단위입니다. 연동마다 테스트와 라이브 환경이 있고, 환경별로 API 인증키, 웹훅, 발급자를 따로 관리합니다.

같은 연동의 같은 환경에서 발급한 인증키는 발급자를 공유합니다. 이 범위에서 인증키를 교체해도 발급자를 다시 등록하지 않습니다. 다른 연동이나 테스트와 라이브 환경 사이에는 발급자를 공유하지 않습니다.

[개발자센터](https://developers.bolta.io)에서 \[연동]을 여세요. 화면 위의 연동 이름을 클릭해 다른 연동을 고르고, 연동 이름 옆의 \[테스트] 또는 \[라이브]로 환경을 바꾸세요.

## 연동 추가

연동 선택 메뉴에서 \[연동 추가]를 클릭하세요. 사내 ERP, 정산 시스템처럼 구분할 이름을 입력하고 \[연동 추가]를 클릭합니다. 새 연동은 테스트 환경으로 열립니다.

## 연동 개요 확인

\[연동] > \[연동 개요]에서 선택한 환경의 준비 상태를 확인하세요. API 인증키 수, 발급자 수, 웹훅 수신 상태와 최근 웹훅 전송, 최근 API 요청을 보여 줍니다.

![연동 개요의 준비 상태와 최근 전송, 요청](https://mintcdn.com/bolta/5nOYEzGySbtKGELd/images/docs/guide-developer-overview.png?fit=max\&auto=format\&n=5nOYEzGySbtKGELd\&q=85\&s=bb035efdaf6f0ddfb32ea26b6bfa1fe8)

준비하지 않은 단계가 있으면 아래 순서로 안내합니다.

1. [인증키 발급](https://docs.bolta.io/docs/developer-center/api-key.md)
2. [발급자와 인증서 등록](https://docs.bolta.io/docs/developer-center/issuers.md): 세금계산서나 현금영수증을 발행할 때만 필요합니다.
3. API 호출: API 문서를 참고해 이 환경의 인증키로 첫 요청을 보내세요.
4. [웹훅 수신](https://docs.bolta.io/docs/developer-center/webhook-connection.md): 처리 결과를 이벤트로 받을 때 설정합니다.

최근 웹훅 전송이 실패했거나 인증서를 확인해야 하면 화면 위에 안내를 표시합니다. \[실패 사유 보기] 또는 \[발급자 확인]을 클릭해 조치하세요.

## 연동 이름 변경과 삭제

\[연동] > \[연동 설정]에서 \[이름 변경]을 클릭하고 새 이름을 입력한 뒤 \[이름 저장]을 클릭하세요. 이름은 테스트와 라이브 환경에 함께 적용합니다.

![연동 설정의 연동 이름과 연동 삭제](https://mintcdn.com/bolta/5nOYEzGySbtKGELd/images/docs/guide-developer-integration-settings.png?fit=max\&auto=format\&n=5nOYEzGySbtKGELd\&q=85\&s=cc135ecdd5332b226fd7daea9ffec6a4)

\[연동 삭제]를 클릭하고 확인 창에 연동 이름을 입력한 뒤 \[연동 삭제]를 클릭하세요. 삭제하면 테스트와 라이브 환경의 인증키를 모두 폐기하고 웹훅 수신 주소를 지웁니다. 발행한 문서는 남지만 이 연동의 요청 기록과 웹훅 이력은 더 볼 수 없습니다. 삭제한 연동은 되돌릴 수 없고, 마지막 연동은 삭제할 수 없습니다.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.