이벤트 타입
현금영수증 발행·취소는 비동기입니다. API가 최종 결과를 다음 이벤트로 전송합니다.페이로드
발행 성공
발행 실패
취소 성공
취소 실패
다음 두 코드는
CASH_RECEIPT_CANCEL_FAILED에서만 반환됩니다.
ORIGINAL_ISSUANCE_FAILED: 원본 발행이 처리 중일 때 취소 요청을 접수했지만, 이후 원본 발행이 최종 실패한 경우CANCELLATION_TARGET_NOT_FOUND: 취소 대상이 확인되지 않거나 이미 취소되었거나, 같은 현금영수증의 취소 요청이 이미 접수된 경우
외부 취소
발행된 현금영수증이 볼타 외부(예: 홈택스)에서 취소되면 이 이벤트를 전송합니다.웹훅 발송 시간
발송 시점은 키와 처리 결과에 따라 다릅니다. LIVE 키는 최종 상태가 바뀐 뒤 결과 웹훅 전송을 시작합니다.
테스트 키(
test_)는 요청 처리 후 최종 상태를 바로 기록합니다. 자동 웹훅은 요청 접수 시각부터 최소 10초 뒤에 전송합니다.
같은 이벤트를 두 번 이상 받을 수 있으므로 eventType과 issuanceKey를 기준으로 멱등 처리하세요. 최종 상태가 바뀌는 시점과 HTTP 수신 시점은 다를 수 있습니다.
웹훅이 오지 않을 때
현금영수증 발행 상태 조회로 확인하세요.PENDING은 요청을 접수했고 처리를 시작하기 전 상태입니다. REQUEST_SUCCESS는 요청 전달이 끝났다는 뜻일 뿐 최종 결과를 뜻하지 않습니다. LIVE 요청이 처리 중이거나 발행 결과 확인을 기다리는 상태라면 요청일 다음 날 17:00(KST) 이후에 결과를 다시 확인하세요.