현금영수증 취소 API

요청 정보

전체 취소는 mod_type에 STSC를 사용합니다.
부분 취소는 mod_type에 STPC를 사용하고, mod_mny와 rem_mny를 함께 전송합니다.
현금영수증 발급 응답으로 받은 cash_no 값을 mod_value에 설정하세요.

전체 취소 Request Body 예시

{
	"site_cd": "T0000",
	"kcp_cert_info": "-----BEGIN CERTIFICATE-----...-----END CERTIFICATE-----",
	"kcp_sign_data": "OehQsMb7S8KTCrp6Bi6fEVft...Y7ZX1BI3A==",
	"mod_type": "STSC",
	"mod_gubn": "MG01",
	"mod_value": "25834156556924"
}

부분 취소 Request Body 예시

{
	"site_cd": "T0000",
	"kcp_cert_info": "-----BEGIN CERTIFICATE-----...-----END CERTIFICATE-----",
	"kcp_sign_data": "OehQsMb7S8KTCrp6Bi6fEVft...Y7ZX1BI3A==",
	"mod_type": "STPC",
	"mod_gubn": "MG01",
	"mod_value": "25834156556924",
	"mod_mny": "500",
	"rem_mny": "1000"
}

요청 파라미터

응답 정보

취소 응답의 cash_no에는 취소 요청한 현금영수증 거래번호가 리턴됩니다.
receipt_no에는 취소 승인번호가 리턴되며, 발급 시 받은 승인번호와 다른 값이므로 별도로 저장하세요.
현금영수증 취소 요청도 NHN KCP와 국세청에 등록되며, reg_stat과 reg_desc로 현재 상태를 확인할 수 있습니다.
취소 실패 시 res_cd와 res_msg 외의 응답 데이터는 리턴되지 않습니다.

Response Body 예시

{
	"res_cd": "0000",
	"res_msg": "정상처리",
	"cash_no": "25834156556924",
	"receipt_no": "591320761",
	"app_time": "20251231144020",
	"reg_stat": "NTRW",
	"reg_desc": "KCP 등록 완료"
}

응답 파라미터

구현 참고사항

// 현금영수증 취소 서명데이터 생성
String targetData = siteCd + "^"
                  + modValue + "^"
                  + modType;

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

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

현금영수증 등록 상태 코드