API 레퍼런스현금영수증 API
현금 영수증 상태 확인
발급된 현금영수증의 상태를 조회합니다. 국세청 전송 상태, 발급 완료 여부 등을 확인할 수 있습니다.
각 API 응답 필드와 에러코드는 사전 공지 없이 추가되거나 변경될 수도 있으니, 추가된 항목으로 인해 오류가 발생하지 않도록 처리에 유의해 주시기 바랍니다.
POST
https://pay.toss.im/api/v2/cash-receipt-info요청 파라미터
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(취소 거래시) 국세청 승인 원거래일시