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_KEYYYYY-MM-DD로 표시된 두 날짜를 실제 값으로 바꾼 뒤 요청하세요. 두 date 필드는 발행 마감일 이내의 날짜로 설정해야 합니다. 예시의 두 identificationNumber는 체크섬을 통과하지 않는 자리표시자입니다. 실제 사업자등록번호로 바꾸세요.

응답 확인

발행 요청이 성공하면 issuanceKey가 반환됩니다.
이후 웹훅으로 발행 완료 알림이 전송되며, 세금계산서 조회 API로 결과를 확인할 수 있습니다.

다음 단계

인증 가이드

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

발행 금액 계산

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

사용 사례

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

API Reference

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