현금영수증 발급 API

요청 정보

가맹점의 사이트에서 하위업체(입점몰)의 현금결제가 일어나는 경우에도 현금영수증 등록이 가능합니다.
사업자 구분(corp_type) 값이 1인 경우 입점몰 판매로 구분되므로, 입점몰 정보 파라미터를 설정해 등록해야 합니다.
전달한 입점몰 정보는 현금영수증 전표에도 표시되어 고객이 해당 정보를 확인할 수 있습니다.

직접 판매 Request Body 예시

{
	"site_cd": "T0000",
	"kcp_cert_info": "-----BEGIN CERTIFICATE-----...-----END CERTIFICATE-----",
	"pay_method": "CASH",
	"user_type": "PGNW",
	"trad_time": "20251231101030",
	"tr_code": "0",
	"id_info": "01012345678",
	"amt_tot": "1000",
	"amt_sup": "909",
	"amt_tax": "91",
	"ordr_idxx": "TEST123456789",
	"good_name": "상품명",
	"buyr_name": "홍길동",
	"buyr_mail": "test@your-shop.example.com",
	"corp_type": "0"
}

입점몰 판매 Request Body 예시

{
	"site_cd": "T0000",
	"kcp_cert_info": "-----BEGIN CERTIFICATE-----...-----END CERTIFICATE-----",
	"pay_method": "CASH",
	"user_type": "PGNW",
	"trad_time": "20251231101030",
	"tr_code": "0",
	"id_info": "01012345678",
	"amt_tot": "1000",
	"amt_sup": "909",
	"amt_tax": "91",
	"ordr_idxx": "TEST123456789",
	"good_name": "상품명",
	"buyr_name": "홍길동",
	"buyr_mail": "test@your-shop.example.com",
	"corp_type": "1",
	"corp_tax_type": "TG01",
	"corp_tax_no": "1234567890",
	"corp_sell_tax_no": "1234567890",
	"corp_nm": "NHN KCP",
	"corp_owner_nm": "홍길동",
	"corp_addr": "서울시 구로구 디지털로26길 72",
	"corp_telno": "02-0000-0000",
	"corp_site_url": "www.kcp.co.kr"
}

요청 파라미터

응답 정보

발급 응답의 cash_no와 receipt_no는 현금영수증 조회·취소 및 가맹점 거래 관리에 사용하므로 저장하세요.
발급 실패 시 res_cd와 res_msg 외의 응답 데이터는 리턴되지 않습니다.

Response Body 예시

{
	"res_cd": "0000",
	"res_msg": "정상처리",
	"cash_no": "24834156556924",
	"receipt_no": "591007373",
	"app_time": "20251231114501",
	"reg_stat": "NTRW",
	"reg_desc": "KCP 등록 완료"
}

응답 파라미터

구현 참고사항

// 서비스 인증서 직렬화 예시
String kcpCertInfo = Files.readAllLines(certPath)
    .stream()
    .map(String::trim)
    .collect(Collectors.joining());

JSONObject body = new JSONObject();
body.put("site_cd", "T0000");
body.put("kcp_cert_info", kcpCertInfo);
body.put("pay_method", "CASH");
body.put("user_type", "PGNW");
body.put("trad_time", "20251231101030");
body.put("tr_code", "0");
body.put("id_info", "01012345678");
body.put("amt_tot", "1000");
body.put("amt_sup", "909");
body.put("amt_tax", "91");

현금영수증 등록 상태 코드