API 레퍼런스현금영수증 API
현금 영수증 상태 확인
발급된 현금영수증의 상태를 조회합니다. 국세청 전송 상태, 발급 완료 여부 등을 확인할 수 있습니다.
각 API 응답 필드와 에러코드는 사전 공지 없이 추가되거나 변경될 수도 있으니, 추가된 항목으로 인해 오류가 발생하지 않도록 처리에 유의해 주시기 바랍니다.
POST
요청 파라미터
apiKeystring필수결제 가맹점의 API Key. API Key는 LIVE 값만 동작하며 TEST 값은 무시됩니다.
최대 30자
payTokenstring필수결제토큰
최대 30자
응답 파라미터
codeinteger (int32)응답코드. 0: 성공, -1: 실패 (실패 사유는 msg와 errorCode로 제공)
errorCodestring에러 코드
msgstring응답이 성공이 아닌 경우 설명 메시지
cashReceiptMgtKeystring현금영수증 관리번호 값
customerNamestring현금영수증 신청 고객명
itemNamestring상품명
identityNumstring고객 식별번호. 현금영수증 발급 당시 사용한 고객 식별번호 (예: 휴대폰번호, 사업자등록번호 등)
taxationTypestring과세형태 (과세 / 비과세)
totalAmountstring현금영수증 발급 총액
supplyCoststring공급가액 (과세금액 + 비과세금액)
taxstring부가세
serviceFeestring봉사료
tradeUsagestring발급 목적 (소득공제용 / 지출증빙용)
tradeTypestring거래유형 (승인거래 / 취소거래)
statusstring현금영수증 상태. IN_PROGRESS: 국세청 전송중, ISSUE_APPLIED: 발급 신청 완료, ISSUE_COMPLETE: 발급 완료, ISSUE_FAILED: 발급 실패
ntsResultstring국세청 리턴 결과
confirmNumstring발행승인번호
confirmTsstring (date-time)발행일시. ISO-8601 형식 (예: 2019-03-21T14:02:49)
tradeDatestring등록 요청 날짜
orgConfirmNumstring(취소 거래시) 국세청 승인 원번호
orgTradeDatestring(취소 거래시) 국세청 승인 원거래일시