API Reference > 거래취소
거래취소
거래취소
NHN KCP 거래 취소 API를 통해 승인된 결제를 취소처리 할 수 있습니다.
테스트 : https://stg-spl.kcp.co.kr/gw/mod/v1/cancel
운영 : https://spl.kcp.co.kr/gw/mod/v1/cancel
Header
Protocol: HTTPS
HTTP Method: POST
Content-Type: application/json; charset=UTF-8
Request Body 파라미터
//전체취소
{
"site_cd" : "T0000",
"kcp_cert_info" : "-----BEGIN CERTIFICATE-----MIIDgTCCAmmgAwIBAgI…==-----END CERTIFICATE-----",
"kcp_sign_data" : "==QdwMF6y3GU1JTVkSv7Yn20CCCTeFrKkjvrdZOjShiFibFo...==",
"mod_type" : "STSC",
"tno" : "2099123112345"
}
//부분취소
{
"site_cd" : "T0000",
"kcp_cert_info" : "-----BEGIN CERTIFICATE-----MIIDgTCCAmmgAwIBAgI==-----END CERTIFICATE-----",
"kcp_sign_data" : "QdwMF6y3GU1JTVkSv7Yn20CCCTeFrKkjvrdZOjShZ...0qH7NSq0c6BpedDZb04w==",
"mod_type" : "STPC",
"tno" : "2099123112345",
"mod_mny" : "5000",
"rem_mny" : "10000",
"mod_desc" : "취소 사유를 입력하세요"
}
site_cd
NHN KCP 발급 사이트(상점)코드
테스트코드 : T0000
ex) "site_cd" : "T0000"
tno
NHN KCP 거래 고유번호
ex) "tno" : "24123456789012"
kcp_cert_info
NHN KCP 인증서정보(직렬화)
관리자 페이지에서 발급받은 인증서 정보(직렬화 하여 요청)
ex) "kcp_cert_info" : "-----BEGIN CERTIFICATE-----MIIDgTCCAmmgAwIBAgIHkiG9w0…………Cay7pJNWXCnw4jIiBsTBa3q95RVRyMEcDgPwugMXPXGBwNoMOOpuQ==-----END CERTIFICATE-----"
kcp_sign_data
NHN KCP 암호화데이터
site_cd + "^" + tno + "^" + mod_type
ex) "kcp_sign_data" : "QdwMF6y3GU1JTVkSv7Yn20CCCTeFrKkjvrdZOjShiFibFo...
cA0nyX+4HEUZ4Fy3U+htmkZqAfJljeujC1KAL5Flnzqbp5Tst5p5SvZ...
0qH7NSq0c6BpedDZb04w=="
mod_type필수
전체 승인취소 - STSC / 부분취소 - STPC
ex) "mod_type" : "STSC"
mod_mny
부분취소일 경우 부분취소금액
ex) "mod_mny" : "500"
rem_mny
부분취소 가능금액
ex) "rem_mny" : "1004"
mod_desc
취소사유
ex) "mod_desc" : "고객변심"
tax_flag
복합과세 구문
복합과세 거래를 부분취소 할 때 사용하며 TG03 고정값이 사용됩니다.
복합과세 부분취소 시에는 요청금액이 부분 취소 요청 공금가액, 부가가치세, 비과세를 합한 금액과 동일해야 합니다.
(mod_mny = mod_tax_mny + mod_vat_mny + mod_free_mny)
ex) "tax_flag" : "TG03"
mod_tax_mny
부분취소 공급가액
부분취소 요청 금액 중(mod_mny) 공급가액에 해당하는 금액을 입력합니다.
ex) "mod_tax_mny" : "363"
mod_vat_mny
부분취소 부가가치세
부분취소 요청 금액 중(mod_mny) 부가가치세에 해당하는 금액을 입력합니다.
부가가치세는 부분취소 요청 금액 mod_mny 중 부분취소 비과세 금액을 제외한 금액의 10%입니다.
ex) "mod_vat_mny" : "37"
mod_free_mny
부분취소 비과세
부분취소 요청 금액 중(mod_mny) 비과세에 해당하는 금액을 입력합니다.
ex) "mod_free_mny" : "0"
Response 파라미터
res_cd
결과코드
정상 승인이 이루어졌을 경우 ‘0000’ 값 리턴
ex) "res_cd" : "0000"
res_msg
결과메세지
ex) "res_msg" : "정상처리"
tno
NHN KCP 거래 고유번호
※ 거래고유번호 전체로 사용 하시기 바랍니다.
(임의의 숫자나 파싱하여 사용 불가)
ex) "tno" : "24123456789012"
canc_time
취소시각
ex) "canc_time" : "20260131235959"
mod_mny
부분취소일 경우 부분취소금액
ex) "mod_mny" : "500"
rem_mny
부분취소 후 남은 금액
ex) "rem_mny" : "504"
mod_pcan_seq_no
부분취소 일련번호
ex) "mod_pcan_seq_no" : "24080546646043"
card_mod_mny
카드취소금액(부분취소일 경우)
부분취소금액 중 카드취소 금액
ex) "card_mod_mny" : "500"
coupon_mod_mny
쿠폰취소금액(부분취소일 경우)
부분취소금액 중 쿠폰취소 금액
ex) "coupon_mod_mny" : "0"