현금영수증 조회 API

요청 정보

현금영수증 조회는 현금영수증 거래번호로 요청합니다. 발급 응답으로 받은 cash_no 값을 tno에 설정하세요.
조회 요청에는 서명데이터가 필요하며, 가맹점 개인키로 생성한 kcp_sign_data를 함께 전송합니다.

Request Body 예시

{
	"site_cd": "T0000",
	"kcp_cert_info": "-----BEGIN CERTIFICATE-----...-----END CERTIFICATE-----",
	"kcp_sign_data": "OehQsMb7S8KTCrp6Bi6fEVft...Y7ZX1BI3A==",
	"pay_type": "CASH",
	"tno": "25834156556924"
}

요청 파라미터

응답 정보

현금영수증의 발급·취소 상태가 res_cash_info 배열로 리턴됩니다.
발급 후 취소된 거래는 발급 건과 취소 건이 각각 배열 항목으로 포함될 수 있으므로, 각 항목의 tx_type과 reg_stat을 기준으로 처리하세요.
조회 실패 시 res_cd와 res_msg 외의 조회 응답 데이터는 리턴되지 않습니다.

Response Body 예시

{
	"res_cd": "0000",
	"res_msg": "정상처리",
	"res_en_msg": "processing completed",
	"res_cash_info": [
		{
			"cash_no": "25834156556924",
			"receipt_no": "591482610",
			"trade_time": "20251231115951",
			"proc_time": "20251231143944",
			"reg_stat": "NTRW",
			"reg_desc": "KCP 등록 완료",
			"tx_type": "A"
		},
		{
			"cash_no": "25834156556924",
			"receipt_no": "591320760",
			"trade_time": "20251231115951",
			"proc_time": "20251231144001",
			"reg_stat": "NTRW",
			"reg_desc": "KCP 등록 완료",
			"tx_type": "P"
		}
	]
}

응답 파라미터

구현 참고사항

// 현금영수증 조회 서명데이터 생성
String targetData = siteCd + "^"
                  + tno + "^"
                  + payType;

Signature signature = Signature.getInstance("SHA256WithRSA");
signature.initSign(privateKey);
signature.update(targetData.getBytes(StandardCharsets.UTF_8));

String kcpSignData =
    Base64.getEncoder().encodeToString(signature.sign());

현금영수증 등록 상태 코드