Skip to main content
전송 방식과 방화벽 설정, 로그 확인은 웹훅 이벤트를 참고하세요.

이벤트 타입

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

페이로드

발행 성공

발행 실패

취소 성공

취소 실패

다음 두 코드는 CASH_RECEIPT_CANCEL_FAILED에서만 반환됩니다.
  • ORIGINAL_ISSUANCE_FAILED: 원본 발행이 처리 중일 때 취소 요청을 접수했지만, 이후 원본 발행이 최종 실패한 경우
  • CANCELLATION_TARGET_NOT_FOUND: 취소 대상이 확인되지 않거나 이미 취소되었거나, 같은 현금영수증의 취소 요청이 이미 접수된 경우

외부 취소

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

웹훅 발송 시간

발송 시점은 키와 처리 결과에 따라 다릅니다. LIVE 키는 최종 상태가 바뀐 뒤 결과 웹훅 전송을 시작합니다. 테스트 키(test_)는 요청 처리 후 최종 상태를 바로 기록합니다. 자동 웹훅은 요청 접수 시각부터 최소 10초 뒤에 전송합니다. 같은 이벤트를 두 번 이상 받을 수 있으므로 eventTypeissuanceKey를 기준으로 멱등 처리하세요. 최종 상태가 바뀌는 시점과 HTTP 수신 시점은 다를 수 있습니다.
202 Accepted는 요청 접수만 뜻합니다. 상태 조회에서 ISSUED를 확인하거나 CASH_RECEIPT_ISSUED 웹훅을 받기 전까지 발행 미확정으로 처리하세요.

웹훅이 오지 않을 때

현금영수증 발행 상태 조회로 확인하세요. PENDING은 요청을 접수했고 처리를 시작하기 전 상태입니다. REQUEST_SUCCESS는 요청 전달이 끝났다는 뜻일 뿐 최종 결과를 뜻하지 않습니다. LIVE 요청이 처리 중이거나 발행 결과 확인을 기다리는 상태라면 요청일 다음 날 17:00(KST) 이후에 결과를 다시 확인하세요.