API Reference > 거래조회

거래조회

거래조회(미작업)

테스트 : https://stg-spl.kcp.co.kr/std/inquery
 운영 : https://spl.kcp.co.kr/std/inquery

Header

Protocol: HTTPS
HTTP Method: POST
Content-Type: application/json; charset=UTF-8

Request Body 파라미터

거래 번호로 조회할 경우


{
 "site_cd"         : "T0000",
 "kcp_cert_info"   : "-----BEGIN CERTIFICATE-----MIIDgTCCAmmgAwIBAgI……………
                          fWn5Cay7pJNWXCnw4jIiBsTBa3q95RVRyMEcDgPwugMXPXGBwNoMOOpuQ==-----END CERTIFICATE-----",
 "kcp_sign_data"   : "QdwMF6y3GU1JTVkSv7Yn20CCCTeFrKkjvrdZOjShiFibFo...
                          cA0nyX+4HEUZ4Fy3U+htmkZqAfJljeujC1KAL5Flnzqbp5Tst5p5SvZ...0qH7NSq0c6BpedDZb04w==",
 "pay_type"        : "PACA",
 "tno"             : "2099123112345"
}

주문 번호로 조회할 경우


{
 "site_cd"         : "T0000",
 "kcp_cert_info"   : "-----BEGIN CERTIFICATE-----MIIDgTCCAmmgAwIBAgI……………
                          fWn5Cay7pJNWXCnw4jIiBsTBa3q95RVRyMEcDgPwugMXPXGBwNoMOOpuQ==-----END CERTIFICATE-----",
 "kcp_sign_data"   : "QdwMF6y3GU1JTVkSv7Yn20CCCTeFrKkjvrdZOjShiFibFo...
                          cA0nyX+4HEUZ4Fy3U+htmkZqAfJljeujC1KAL5Flnzqbp5Tst5p5SvZ...0qH7NSq0c6BpedDZb04w==",
 "pay_type"        : "PACA",
 "tno"             : "2099123112345",
 "mod_ordr_idxx"         : "TEST12345678914675",
}

string5

site_cd

NHN KCP 발급 사이트(상점)코드
테스트코드 : T0000
ex) "site_cd" : "T0000"

string14

tno

NHN KCP 거래 고유번호
ex) "tno" : "24123456789012"

string가변

kcp_cert_info

NHN KCP 인증서정보(직렬화)
관리자 페이지에서 발급받은 인증서 정보(직렬화 하여 요청)
ex) "kcp_cert_info" : "-----BEGIN CERTIFICATE-----MIIDgTCCAmmgAwIBAgIHkiG9w0…………Cay7pJNWXCnw4jIiBsTBa3q95RVRyMEcDgPwugMXPXGBwNoMOOpuQ==-----END CERTIFICATE-----"

string가변

kcp_sign_data

NHN KCP 암호화데이터
site_cd + "^" + tno + "^" + mod_type
ex) "kcp_sign_data" : "QdwMF6y3GU1JTVkSv7Yn20CCCTeFrKkjvrdZOjShiFibFo... cA0nyX+4HEUZ4Fy3U+htmkZqAfJljeujC1KAL5Flnzqbp5Tst5p5SvZ... 0qH7NSq0c6BpedDZb04w=="

string4

mod_type

전체 승인취소 - STSC / 부분취소 - STPC
ex) "mod_type" : "STSC"

number12

mod_mny

부분취소일 경우 부분취소금액
ex) "mod_mny" : "500"

number12

rem_mny

부분취소 가능금액
ex) "rem_mny" : "1004"

string100

mod_desc

취소사유
ex) "mod_desc" : "고객변심"

string4

tax_flag

복합과세 구문
복합과세 거래를 부분취소 할 때 사용하며 TG03 고정값이 사용됩니다.
복합과세 부분취소 시에는 요청금액이 부분 취소 요청 공금가액, 부가가치세, 비과세를 합한 금액과 동일해야 합니다.
(mod_mny = mod_tax_mny + mod_vat_mny + mod_free_mny)
ex) "tax_flag" : "TG03"

number12

mod_tax_mny

부분취소 공급가액
부분취소 요청 금액 중(mod_mny) 공급가액에 해당하는 금액을 입력합니다.
ex) "mod_tax_mny" : "363"

number12

mod_vat_mny

부분취소 부가가치세
부분취소 요청 금액 중(mod_mny) 부가가치세에 해당하는 금액을 입력합니다.
부가가치세는 부분취소 요청 금액 mod_mny 중 부분취소 비과세 금액을 제외한 금액의 10%입니다.
ex) "mod_vat_mny" : "37"

number12

mod_free_mny

부분취소 비과세
부분취소 요청 금액 중(mod_mny) 비과세에 해당하는 금액을 입력합니다.
ex) "mod_free_mny" : "0"

Response 파라미터

string4

res_cd

결과코드
정상 승인이 이루어졌을 경우 ‘0000’ 값 리턴
ex) "res_cd" : "0000"

string100

res_msg

결과메세지
ex) "res_msg" : "정상처리"

string14

tno

NHN KCP 거래 고유번호
※ 거래고유번호 전체로 사용 하시기 바랍니다. (임의의 숫자나 파싱하여 사용 불가)
ex) "tno" : "24123456789012"

string14

canc_time

취소시각
ex) "canc_time" : "20240131235959"

number12

mod_mny

부분취소일 경우 부분취소금액
ex) "mod_mny" : "500"

number12

rem_mny

부분취소 후 남은 금액
ex) "rem_mny" : "504"

string14

mod_pcan_seq_no

부분취소 일련번호
ex) "mod_pcan_seq_no" : "24080546646043"

number12

card_mod_mny

카드취소금액(부분취소일 경우)
부분취소금액 중 카드취소 금액
ex) "card_mod_mny" : "500"

number12

coupon_mod_mny

쿠폰취소금액(부분취소일 경우)
부분취소금액 중 쿠폰취소 금액
ex) "coupon_mod_mny" : "0"

거래조회

거래조회(미작업)

Header

Request Body 파라미터

Response 파라미터

문서 목차