현금영수증 발급상태 조회 API
주문번호 또는 승인번호로 현금영수증의 국세청 발급상태를 확인합니다.
주의사항
NOTE
조회 키 입력 기준
이 API는 국세청 최종 발급 상태를 확인하는 용도입니다. transNo(주문번호)와 authNo(승인번호) 중 하나를 반드시 입력하고, 등록 상태는 assort=0, 취소 상태는 assort=1로 조회하세요.
API 정보
GET/POST/pgtrans/CashReceiptMultiAction.do?_method=getReceiptStatus
Content-Type
요청
application/x-www-form-urlencoded;charset=UTF-8응답
text/plain;charset=UTF-8테스트
https://tcash.settlebank.co.kr/pgtrans/CashReceiptMultiAction.do?_method=getReceiptStatus운영
https://cash.settlebank.co.kr/pgtrans/CashReceiptMultiAction.do?_method=getReceiptStatus요청 파라미터
타입 표기법
N숫자A영문H한글AN영문+숫자AHN영문+한글+숫자예: AN(10) = 영문+숫자, 최대 10byte
└midAN(10)영문+숫자, 최대 10byte*상점아이디
상점아이디
└trDtAN(14)영문+숫자, 최대 14byte*발행/취소 요청일자 (yyyyMMddHHmmss)
발행/취소 요청일자 (yyyyMMddHHmmss)
*년월일시분초까지 일치 또는 년월일(YYYYMMDD)만 입력해도 조회 가능
└assortA(1)영문, 최대 1byte*발행/취소 구분
발행/취소 구분
0: 발행 1: 취소└transNoAN(50)영문+숫자, 최대 50byte주문번호 (가맹점 고유번호)
주문번호 (가맹점 고유번호)
*날짜와 상관없이 동일 고유번호 발생 시 오류처리. transNo 또는 authNo 중 하나 필수
└authNoAN(9)영문+숫자, 최대 9byte발행/취소 시 응답받은 국세청 승인번호
발행/취소 시 응답받은 국세청 승인번호
*transNo 또는 authNo 중 하나 필수
응답 파라미터
타입 표기법
N숫자A영문H한글AN영문+숫자AHN영문+한글+숫자예: AN(10) = 영문+숫자, 최대 10byte
└resultCdAN(4)영문+숫자, 최대 4byte*응답코드
0021응답코드
1113: 거래내역없음 0011: 발행요청 대기중(국세청 전송 전 또는 결과 미수신) 0021: 발행성공(국세청 정상 응답) 0031: 발행실패(국세청 오류 응답)└resultMsgAHN(100)영문+한글+숫자, 최대 100byte*응답메시지
00응답메시지
*1113(거래내역없음), 0011(발행요청 대기중): 공백 / 0021(발행성공): '00' / 0031(발행실패): 국세청 오류코드
└tr_dtN(14)숫자, 최대 14byte발급일시 (yyyyMMddHHmmss)
20220215121346발급일시 (yyyyMMddHHmmss)
└transNoAN(50)영문+숫자, 최대 50byte주문번호 (가맹점 고유번호)
FA202212345666주문번호 (가맹점 고유번호)
└authNoAN(9)영문+숫자, 최대 9byte승인번호
F67143122승인번호
요청 예시
https://tcash.settlebank.co.kr/pgtrans/CashReceiptMultiAction.do?_method=getReceiptStatus
&mid=mid_test
&trDt=20220215121346
&assort=0
&transNo=FA202212345666
또는 승인번호로 조회:
https://tcash.settlebank.co.kr/pgtrans/CashReceiptMultiAction.do?_method=getReceiptStatus
&mid=mid_test
&trDt=20220215121346
&assort=0
&authNo=F67143122
응답 예시
발행 요청 대기중
국세청 전송 전이거나 국세청 전송 후 아직 결과를 수신하지 못한 상태입니다.
{
"resultCd": "0011",
"resultMsg": "",
"trDt": "20220215121346",
"transNo": "FA202212345666",
"authNo": "F67143122"
}
발행 성공
{
"resultCd": "0021",
"resultMsg": "00",
"trDt": "20220215121346",
"transNo": "FA202212345666",
"authNo": "F67143122"
}
발행 실패
{
"resultCd": "0031",
"resultMsg": "TS1(신분확인정보 자릿수 오류)",
"trDt": "20220215121346",
"transNo": "FA202212345666",
"authNo": "F67143122"
}
거래내역 없음
{
"resultCd": "1113",
"resultMsg": "거래내역없음",
"trDt": "",
"transNo": "",
"authNo": ""
}
