메인 콘텐츠로 건너뛰기

연동과 환경 선택

연동은 볼타 API를 사용하는 시스템 단위입니다. 연동마다 테스트와 라이브 환경이 있고, 환경별로 API 인증키, 웹훅, 발급자를 따로 관리합니다. 같은 연동의 같은 환경에서 발급한 인증키는 발급자를 공유합니다. 이 범위에서 인증키를 교체해도 발급자를 다시 등록하지 않습니다. 다른 연동이나 테스트와 라이브 환경 사이에는 발급자를 공유하지 않습니다. 개발자센터에서 [연동]을 여세요. 화면 위의 연동 이름을 클릭해 다른 연동을 고르고, 연동 이름 옆의 [테스트] 또는 [라이브]로 환경을 바꾸세요.

연동 추가

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

연동 개요 확인

[연동] > [연동 개요]에서 선택한 환경의 준비 상태를 확인하세요. API 인증키 수, 발급자 수, 웹훅 수신 상태와 최근 웹훅 전송, 최근 API 요청을 보여 줍니다. 연동 개요의 준비 상태와 최근 전송, 요청 준비하지 않은 단계가 있으면 아래 순서로 안내합니다.
  1. 인증키 발급
  2. 발급자와 인증서 등록: 세금계산서나 현금영수증을 발행할 때만 필요합니다.
  3. API 호출: API 문서를 참고해 이 환경의 인증키로 첫 요청을 보내세요.
  4. 웹훅 수신: 처리 결과를 이벤트로 받을 때 설정합니다.
최근 웹훅 전송이 실패했거나 인증서를 확인해야 하면 화면 위에 안내를 표시합니다. [실패 사유 보기] 또는 [발급자 확인]을 클릭해 조치하세요.

연동 이름 변경과 삭제

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