Skip to main content
GET
현금영수증 발행 상태 조회

인증

Authorization
string
header
필수

API 키를 Base64 인코딩하여 전달합니다. Username에 API 키를 입력하고 Password는 비워두세요.

쿼리 매개변수

clientReferenceId
string
필수

발행·취소 요청에 사용한 Bolta-Client-Reference-Id

Required string length: 1 - 255
Pattern: \S

응답

현금영수증 발행·취소 처리 상태

clientReferenceId
string
필수

요청자 관리번호(Bolta-Client-Reference-Id)

issuanceKey
string
필수

현금영수증 발행 식별 키입니다. 형식과 길이가 바뀔 수 있으므로 문자열 전체를 그대로 저장하세요.

예시:

"MRK98JGC5KOAEIPGK8U6UO05I3EAQPLI8OE78A3I"

type
enum<string>
필수

요청 유형. ISSUE: 발행, CANCELLATION: 취소

사용 가능한 옵션:
ISSUE,
CANCELLATION
status
enum<string>
필수

처리 상태. PENDING은 처리 시작 대기, REQUEST_SUCCESS는 요청 전달 완료이며 둘 다 최종 결과가 아닙니다. ISSUED·CANCELED는 성공, REQUEST_FAILURE·ISSUE_FAILED·CANCEL_FAILED는 실패입니다. EXTERNALLY_CANCELED는 볼타 외부에서 취소된 종료 상태입니다.

사용 가능한 옵션:
PENDING,
REQUEST_SUCCESS,
REQUEST_FAILURE,
ISSUED,
ISSUE_FAILED,
CANCELED,
CANCEL_FAILED,
EXTERNALLY_CANCELED
message
string
필수

처리 상태 안내 메시지. 최종 결과는 statusfailure로 판단하세요.

originalIssuanceKey
string | null

취소 요청의 원본 발행 식별 키

예시:

"MRK98JGC5KOAEIPGK8U6UO05I3EAQPLI8OE78A3I"

cashReceiptApprovalNumber
string | null

발행 성공 시 제공하는 현금영수증 승인번호

failure
object | null

실패 상태일 때 제공하는 실패 사유