메인 콘텐츠로 건너뛰기
전송 방식과 방화벽 설정, 로그 확인은 웹훅 이벤트를 참고하세요.

이벤트 타입

현금영수증 발행과 취소는 비동기입니다. API가 최종 결과를 다음 이벤트로 전송합니다.

페이로드

발행 성공

발행 실패

취소 성공

취소 실패

다음 두 코드는 CASH_RECEIPT_CANCEL_FAILED에만 담깁니다.
  • ORIGINAL_ISSUANCE_FAILED: 원본 발행이 처리 중일 때 취소 요청을 접수했지만, 이후 원본 발행이 최종 실패한 경우
  • CANCELLATION_TARGET_NOT_FOUND: 취소 대상이 확인되지 않거나 이미 취소된 경우. 볼타 외부(예: 홈택스)에서 전액이나 일부가 먼저 취소된 경우, 같은 현금영수증의 취소 요청이 이미 접수된 경우도 해당합니다

외부 취소

발행된 현금영수증이 볼타 외부(예: 홈택스)에서 취소되면 이 이벤트를 전송합니다.

웹훅 발송 시간

테스트 키(test_)는 요청을 처리하면 최종 상태를 바로 기록하고, 요청 접수 시각부터 최소 10초 뒤에 웹훅을 전송합니다. 같은 이벤트를 두 번 이상 받을 수 있습니다. eventType과 issuanceKey를 기준으로 멱등 처리하세요.
202 Accepted는 요청 접수만 뜻합니다. 상태 조회에서 ISSUED를 확인하거나 CASH_RECEIPT_ISSUED 웹훅을 받기 전까지 발행 미확정으로 처리하세요.

웹훅이 오지 않을 때

현금영수증 발행 상태 조회로 확인하세요. LIVE 요청이 처리 중이거나 발행 결과 확인을 기다리는 상태라면 요청일 다음 날 17:00(KST) 이후에 결과를 다시 확인하세요.