​

개발자 도구

​

API 문서

모든 엔드포인트의 상세 문서와 프로그래밍 언어별 코드 샘플을 제공합니다. 지원 언어: Shell, HTTP, JavaScript, Ruby, Python, PHP, Java, Go

​

샌드박스 환경

테스트 키로 API를 테스트하세요.

• 테스트 키 (test_ prefix): 모든 발행 요청을 가상으로 처리하고 국세청에 전송하지 않습니다.
• 라이브 키 (live_ prefix): 실제 환경에서 동작하며, 발행 요청을 국세청에 실제로 전송합니다.

테스트 키와 라이브 키는 개발자센터 > API 키 메뉴에서 생성하세요.

사업자등록 상태 조회는 테스트 키로 가이드에 안내한 고정 번호만 모의 조회합니다. 목록 밖 번호는 400으로 거절하고, 일괄 조회에 목록 밖 번호가 하나라도 섞이면 요청 전체를 거절합니다. 매출/매입 내역 조회는 테스트 키로 호출하면 구독과 관계없이 고정 샘플 매출과 매입을 돌려줍니다. 동기화를 요청해도 수집하지 않습니다. 입출금 내역 조회는 테스트 키로 호출하면 구독과 관계없이 고정 샘플 계좌와 거래를 돌려줍니다. 예금주 조회는 테스트 키로 가이드에 안내한 고정 계좌번호만 모의 조회합니다. 포인트를 차감하지 않으며, 목록 밖 계좌번호는 400으로 거절합니다. 사업자등록증 인식과 진위확인은 테스트 키로 호출하면 올린 파일과 관계없이 고정 결과를 돌려주고 포인트를 차감하지 않습니다. 세금계산서 PDF 조회는 테스트 키로 발행한 건에 바로 샘플 PDF 주소를 돌려줍니다. 202 대기 흐름은 라이브 키로 확인하세요.

​

로깅

웹훅 전송 내역을 확인하세요.

• 웹훅 로그: 발행 완료, 실패 등 이벤트 전송 내역 모니터링

웹훅 설정은 웹훅 연결 가이드를, 로그 확인은 웹훅 로그 가이드를 참고하세요.