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

이벤트 타입

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

페이로드

발행 성공

발행 실패

취소 성공

취소 실패

외부 취소

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

웹훅 발송 시간

발송 시점은 이벤트에 따라 다릅니다. 현금영수증 발행 내역은 홈택스에 다음 날 반영되므로, 발행 성공 웹훅은 다음 날 전송합니다. 테스트 키(test_)는 발행을 가상으로 처리하며, 요청 접수 후 10초 뒤에 최종 웹훅을 전송합니다.
202 Accepted는 요청 접수만 뜻합니다. CASH_RECEIPT_ISSUED를 받기 전까지 발행 미확정으로 처리하세요.

웹훅이 오지 않을 때

현금영수증 발행 상태 조회로 확인하세요. 상태가 PENDING이나 REQUEST_SUCCESS면 결과가 아직 확정되지 않았습니다. REQUEST_SUCCESS는 요청 전달에 성공했다는 뜻이며 발행 성공이 아닙니다.