현금 영수증 상태 확인
각 API 응답 필드와 에러코드는 사전 공지 없이 추가되거나 변경될 수도 있으니, 추가된 항목으로 인해 오류가 발생하지 않도록 처리에 유의해 주시기 바랍니다.
엔드포인트
POSThttps://pay.toss.im/api/v2/cash-receipt-info
요청 파라미터
apiKeystring필수
maxLen: 30
결제 가맹점의 API Key
API Key는 LIVE 값만 동작하며 TEST 값은 무시됩니다.
payTokenstring필수
maxLen: 30
결제토큰
결제토큰
Example Request
{
"apiKey": "example_api_key",
"payToken": "example_payToken"
}응답 파라미터
cashReceiptMgtKeystring
현금영수증 관리번호 값
customerNamestring
현금영수증 신청 고객명
itemNamestring
상품명
identityNumstring
고객 식별번호
현금영수증 발급 당시 사용한 고객 식별번호 (예: 휴대폰번호, 사업자등록번호 등)
taxationTypestring
과세형태
과세형태 (과세 / 비과세)
totalAmountstring
현금영수증 발급 총액
tradeUsagestring
발급 목적
발급 목적 (소득공제용 / 지출증빙용)
tradeTypestring
거래유형
거래유형 (승인거래 / 취소거래)
statusstring
현금영수증 상태
| 값 | 설명 |
|---|---|
| IN_PROGRESS | 국세청 전송중 |
| ISSUE_APPLIED | 발급 신청 완료 |
| ISSUE_COMPLETE | 발급 완료 |
| ISSUE_FAILED | 발급 실패 |
tradeDatestring
등록 요청 날짜
confirmNumstring
발행승인번호
confirmTsstring
발행일시
ISO-8601 형식 (예: 2019-03-21T14:02:49)
Example Response
{
"cashReceiptMgtKey": "123456-123456",
"customerName": "김토스",
"itemName": "테스트 상품",
"identityNum": "01012341234",
"taxationType": "과세",
"totalAmount": "10000",
"tradeUsage": "소득공제용",
"tradeType": "승인거래",
"status": "ISSUE_APPLIED",
"tradeDate": "20180512"
}