메인 콘텐츠로 건너뛰기
플랫폼이 역발행을 요청한 뒤, 승인 URL을 발급받아 플랫폼 내에서 공급자가 직접 승인하는 시나리오입니다. 이메일을 거치지 않고 플랫폼 UX 안에서 승인이 완료됩니다.

워크플로우

공급자 등록

고객 생성 API를 호출하여 공급자 정보를 볼타에 등록합니다. 등록 후 발급되는 customerKey를 저장합니다.

인증서 등록 URL 발급

인증서 등록 URL 조회 API를 호출하여 공급자가 인증서를 등록할 수 있는 URL을 발급받습니다.

공급자 인증서 등록

공급자가 발급받은 URL에 접속하여 공동인증서를 등록합니다. 이 단계는 공급자가 직접 수행해야 합니다.

역발행 요청

역발행 API를 호출합니다. Customer-Key 헤더에 공급자의 customerKey를 전달합니다.

승인 URL 획득

승인 URL 조회 API를 호출하여 승인 페이지 URL을 발급받습니다. 생성된 URL은 10분간 유효합니다.

간편 승인

공급자가 승인 URL에 접속하여 세금계산서를 승인합니다. 플랫폼에서 새 탭 열기, 페이지 이동 등으로 URL을 노출합니다.

발행 완료 웹훅 수신

승인이 완료되면 웹훅으로 taxInvoiceUrl이 포함된 알림이 전송됩니다.

세금계산서 조회 (선택)

세금계산서 조회 API로 발행 결과를 확인합니다.

역발행 요청 취소

승인 전이라면 요청 취소 API를 호출하여 역발행 요청을 취소할 수 있습니다.
  • 정상 취소 시 HTTP 200과 함께 응답이 반환됩니다.
  • 이미 승인/취소/발행된 경우에는 에러가 반환됩니다.
발행 마감일이 지난 경우 승인 불가발행 마감일이 지난 경우 승인할 수 없으므로, 승인 URL 조회 시 400 에러가 응답됩니다. 날짜를 수정하여 다시 요청해주세요.

적합한 경우

  • 플랫폼 UX 안에서 승인 프로세스를 완결하고 싶은 경우
  • 공급자가 이미 인증서를 등록한 상태인 경우
  • 실시간으로 승인 상태를 추적해야 하는 경우

이메일 승인 역발행과의 차이

이메일 승인간편 승인
승인 방식볼타가 보낸 이메일 링크플랫폼이 발급한 승인 URL
인증서 필요불필요필요
UX 제어볼타에 위임플랫폼이 직접 제어
URL 유효시간-10분