Skip to main content

사전 준비

1

회원가입 및 워크스페이스 생성

볼타 회원가입 후 워크스페이스를 생성합니다.
2

테스트 API 키 발급

개발자센터 > API 키 메뉴에서 테스트 키를 생성합니다.테스트 키는 test_로 시작하며, 모든 발행 요청을 가상으로 처리합니다.
3

발급자 등록

발급자 등록 API로 인증서 소유자를 등록합니다. API가 반환한 issuerId는 인증서 관리 API에서 사용합니다.
4

공동인증서 등록

issuerId로 인증서 등록 URL 조회 API를 호출하고, 발급된 URL에서 공동인증서를 등록합니다.
테스트 환경에서는 실제 공동인증서 대신 테스트 인증서로 연동을 테스트하세요.
5

포인트 충전 (라이브 키 사용 시)

라이브 키로 API를 호출하려면 개발자센터에서 포인트를 먼저 충전하세요. 잔액이 부족하면 API 호출이 실패합니다.
테스트 키(test_)는 포인트를 차감하지 않습니다. 상세 요금은 요금 안내를 참고하세요.

첫 번째 API 호출

테스트 API 키를 준비하고 발급자의 공동인증서를 등록했다면, 아래 curl 명령으로 세금계산서를 발행해보세요.
공급받는자 담당자의 휴대전화번호를 함께 보내면 볼타가 세금계산서 수신 안내 알림톡을 보냅니다.
요청 전에 test_YOUR_API_KEY, YYYY-MM-DD로 표시된 두 날짜, 두 identificationNumber를 실제 값으로 바꾸세요. 예시의 identificationNumber는 체크섬을 통과하지 않습니다. quickstart-unique-reference-id는 이전 세금계산서 요청에 사용하지 않은 값으로 바꾸세요. 두 date 필드는 발행 마감일 이내여야 하며, 마감일은 세금계산서 발행 마감일 조회 API로 확인하세요.

응답 확인

발행 요청이 성공하면 API가 issuanceKey를 반환합니다.
응답을 받지 못했다면 같은 요청을 다시 보내지 마세요. 예시에 입력한 quickstart-unique-reference-id로 관리번호 조회 API를 호출해 접수 결과를 확인하세요. 이후 볼타가 웹훅으로 발행 완료를 알립니다. 결과는 세금계산서 조회 API로도 확인할 수 있습니다.

다음 단계

인증 가이드

API 키 인증 방식과 요청 헤더를 자세히 알아보세요.

발행 금액 계산

품목별 금액 계산 방식과 예시를 확인하세요.

사용 사례

B2B 거래, 정기 결제, 역발행 시나리오를 확인하세요.

API Reference

전체 API 엔드포인트 레퍼런스를 확인하세요.