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-----",
    "tno"             : "2099123112345"
    "pay_type"        : "PACA",
    "kcp_sign_data"   : "QdwMF6y3GU1JTVkSv7Yn20CCCTeFrKkjvrdZOjShiFibFo...cA0nyX+4HEUZ4Fy3U+htmkZqAfJljeujC1KAL5Flnzqbp5Tst5p5SvZ...0qH7NSq0c6BpedDZb04w==",
}

주문 번호로 조회할 경우

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

string 5

site_cd 필수 PC / Mobile

NHN KCP와 계약 시 가맹점 고유의 값으로 발급된 코드입니다.
영문대문자 또는 영문 대문자+숫자로 구성됩니다. 모든 서비스에 사용합니다.
ex) "site_cd" : "T0000"

string 가변

kcp_cert_info 필수 PC / Mobile

NHN KCP 에서 발급하는 서비스 인증서로, 모든 서비스에서 사용됩니다.
상점관리자의 인증센터에서 다운받은 pem 파일 내용을 직렬화하여 사용합니다.
ex) "kcp_cert_info" : "-----BEGIN CERTIFICATE-----MIIDjCCAnSgBgkqhBzMQswCYY.....DEghDjJIdwoIdXspogfghrpK8gGsiPl-----END CERTIFICATE-----"

string 가변

kcp_sign_data 필수 PC / Mobile

서명데이터입니다. 상점관리자에서 발급된 개인키를 사용하여 site_cd+"^"+tno+"^"+mod_type 조합으로 생성합니다.
서명데이터 생성 을 참고 바랍니다.
ex) "kcp_sign_data" : "ceCJUAwjjT7+VKVt+...P6wPmg=="

string 14

tno 필수 PC / Mobile

NHN KCP 거래번호입니다. 조회를 진행할 거래번호를 설정합니다.
주문번호로 조회 시에는 조회 건의 결제 일자를 "YYYYMMDD000000" 형식으로 전달 합니다.
거래번호 조회 ex) "tno" : "24822014611200"
주문번호 조회 ex) "tno" : "20240721000000"

string 70

mod_ordr_idxx PC / Mobile

가맹점에서 생성하는 주문 번호입니다. 결제 진행 시, NHN KCP로 전달한 주문번호를 설정 합니다.
주문번호를 조회 키로 요청 시에만 설정합니다.
ex) mod_ordr_idxx : "TEST123456789"

string 4

pay_type 필수 PC / Mobile

결제수단입니다. 조회하고자 하는 결제수단에 맞는 코드로 설정하여 전달합니다.
카드 = PACA
계좌이체 = PABK
가상계좌 = PAVC
휴대폰 = PAMC
상품권 = PATK
SSG머니 = PASG
카카오머니 = PAKM
네이버페이포인트 = PANP
엘포인트 = PALP
토스머니 = PATO
ex) "pay_type" : "PACA"

Response 파라미터

{
    "res_cd"         : "0000",
    "res_msg"        : "정상처리",
    "res_en_msg"     : "processing completed",
    "tno"            : "2454154899967",
    "amount"         : "50000",
    "card_cd"        : "CCBC",
    "card_name"      : "현대카드",
    "app_no"         : "34218266",
    "app_time"       : "20240117102428",
    "quota"          : "00",
    "noinf"          : "N",
    "tax_flag"       : "TG03",
    "card_mny"       : "50000",
    "coupon_mny"     : "0",
    "stat_ca_cd"     : "STSR",
    "canc_card_yn"   : "N",
    "van_time"       : "",
    "rem_mny"        : "50000",
    "card_rem_mny"   : "50000",
    "coupon_rem_mny" : "0",
    "shop_status"    : "STMR",
    "card_no"        : "920020100007232",
    "partcanc_yn"    : "Y",
    "mall_taxno"     : "1138521083"
}

공통 응답

string 4

res_cd always

결과 코드입니다. 정상 처리 된 경우 "0000" 을 리턴합니다.
ex) "res_cd" : "0000"

string 100

res_msg always

결과 메시지 입니다. 정상 처리 된 경우 "정상처리" 를 리턴합니다.
ex) "res_msg" : "정상처리"

string 100

res_en_msg success

영문 결과 메시지입니다. 정상 처리 시에는 "processing completed" 를 리턴합니다.
ex) "res_en_msg" : "processing completed"

string 14

tno success

NHN KCP 거래번호입니다. 거래 건의 고유한 값으로 주문 데이터와 매핑할 값으로 사용할 수 있습니다.
ex) "tno" : "24501234567890"

number 12

amount success

총 결제 금액입니다.
ex) "amount" : "5000"

신용카드 응답

string 4

card_cd success

카드사 코드입니다. 조회된 거래 건의 결제 진행 시 사용한 카드사 코드가 리턴 됩니다.
카드사 코드는 가이드 내 카드사코드 를 참고해 주시기 바랍니다.
ex) "card_cd":"CCSS"

string 20

card_name success

카드사 명입니다. 카드사 명은 카드사코드 를 참고해 주시기 바랍니다.
ex) "card_name":"삼성카드"

string 16

card_no success

카드번호 입니다. 3번째 자리까지 0으로 마스킹 되어 리턴됩니다.
ex) "card_no":"5188310000001541"

string 8

app_no success

카드사 승인번호입니다.
ex) "app_no":"0260087"

string 14

app_time success

승인시간 정보입니다. YYYYMMDDHHMMSS 형식으로 리턴됩니다.
ex) "app_time":"20240617151355"

string 2

quota success

할부 개월 수입니다. 할부 기간이 리턴됩니다.
ex) "quota":"00" [일시불]

string 1

noinf success

무이자여부 입니다. 무이자일 경우, Y로 리턴 됩니다.
ex) "noinf":"N"

number 12

card_mny success

카드 결제 금액입니다. 총 결제 금액 중 카드로 결제된 금액이 리턴 됩니다.
ex) "card_mny":"5000"

number 12

coupon_mny success

쿠폰 결제 금액입니다. 총 결제 금액 중 쿠폰에 적용된 금액이 리턴 됩니다.
ex) "coupon_mny":"0"

number 12

payco_point_mny success

페이코 포인트 결제 금액입니다. 페이코 포인트 결제 건일 경우, 리턴됩니다.
ex) "payco_point_mny":"5000"

number 12

rem_mny success

취소 가능 금액입니다. 부분취소가 진행되었을 경우, 취소 후 남은 총 결제 금액을 의미합니다.
ex) "rem_mny":"5000"

number 12

card_rem_mny success

카드 취소 가능 금액입니다.
ex) "card_rem_mny":"5000"

number 12

coupon_rem_mny success

쿠폰의 취소 가능 금액입니다.
ex) "coupon_rem_mny":"0"

number 12

payco_rem_mny success

페이코 포인트 취소 가능 금액입니다. 페이코 포인트 부분취소가 진행되었을 경우, 취소 후 남은 페이코 포인트 금액을 의미합니다. 페이코 포인트 결제 건일 경우, 리턴됩니다.
ex) "payco_rem_mny":"0"

string 4

stat_ca_cd success

최종 결제 상태입니다. 거래상태 코드를 참고 바랍니다.
ex) "stat_ca_cd":"STSR"

string 4

shop_status success

정산 상태입니다. 거래 건의 정산 상태가 리턴 됩니다. 거래상태 코드 를 참고 바랍니다.
ex) "shop_status":"STSR"

string 1

canc_card_yn success

취소 상태입니다. 취소 상태일 경우 "Y" 로 리턴 됩니다. 승인거래 부분취소 상태일 시에는 N 으로 리턴 됩니다.
ex) "canc_card_yn":"N"

string 14

can_time success

취소시간입니다. YYYYMMDDHHMMSS 형식으로 shop_status가 거래상태 값이 STSC(취소) 일 시에만 리턴 됩니다.
ex) "can_time":"20240613182041"

string 4

tax_flag success

과세유형 입니다. 하기 유형에 맞는 값으로 리턴 됩니다.
TG01 - 과세
TG02 - 비과세
TG03 - 복합과세
ex) "tax_flag":"TG03"

string 1

partcanc_yn success

부분취소 가능여부 입니다. "N" 일 경우, 부분취소가 불가능한 거래 건 입니다.
ex) "partcanc_yn":"Y"

string 10

mall_taxno success

가맹점 사업자번호입니다.
ex) "mall_taxno":"1138521083"

계좌이체 응답

string 7

bk_tid success

계좌이체 승인번호 입니다.
ex) "bk_tid":"5622221"

string 14

app_time success

계좌이체 결제 시각 정보입니다. YYYYMMDDHHMMSS 형식으로 리턴됩니다.
ex) "app_time":"20240617151355"

string 4

bk_code success

계좌이체 은행 코드입니다. 계좌이체 진행 시 이용한 은행 코드가 리턴 됩니다.
은행 코드는 가이드 내 은행 코드 를 참고해주시기 바랍니다.
ex) "bk_code":"BK04"

string 20

bk_name success

계좌이체 은행 명입니다. 은행 명은 은행 코드 를 참고해주시기 바랍니다.
ex) "bk_name":"국민은행"

number 12

bk_mny success

계좌이체 이체 금액입니다.
ex) "bk_mny":"5000"

number 12

rem_mny success

취소 가능 금액입니다. 부분취소가 진행되었을 경우, 취소 후 남은 총 결제 금액을 의미합니다.
ex) "rem_mny":"5000"

number 12

bk_rem_mny success

계좌이체 취소 가능 금액입니다. 부분취소가 진행되었을 경우, 취소 후 남은 총 결제 금액을 의미합니다.
ex) "bk_rem_mny":"5000"

string 4

stat_bk_cd success

최종 결제 상태입니다. 거래상태 코드 를 참고 바랍니다.
ex) "stat_bk_cd":"STSR"

string 4

shop_status success

정산 상태입니다. 상태값은 거래상태 코드 를 참고 바랍니다.
ex) "shop_status":"STSR"

string 1

escw_yn success

에스크로 여부입니다. 에스크로 결제 건일 경우, Y 로 리턴 됩니다.
ex) "escw_yn":"N"

string 1

bk_receipt_gubn success

현금영수증 등록 여부입니다. 조회된 거래 건에 현금영수증 등록 상태가 리턴 됩니다.
Y : 발급
S : 자진발급
N : 발급안됨
C : 취소
P : 부분취소
ex) "bk_receipt_gubn":"Y"

string 9

cash_authno success

현금영수증 승인번호 입니다. bk_receipt_gubn 이 Y 인 경우, 리턴 됩니다.
ex) "cash_authno":""

string 20

bk_taxno success

현금영수증 등록정보 입니다.
현금영수증 발급 용도에 대한 휴대폰번호, 사업자번호 또는 현금영수증 카드번호가 리턴 됩니다.
ex) "bk_taxno":"01012345678"

string 1

canc_bk_yn success

취소된 계좌이체 건은 Y 로 리턴됩니다.
ex) "canc_bk_yn":"Y"

가상계좌 응답

number 12

ipkum_money success

가상계좌 입금 금액입니다. 입금이 진행되지 않았을 경우, 0으로 리턴 됩니다.
ex) "ipkum_money":"5000"

string 4

bankcode success

가상계좌 입금 은행코드 입니다. 발급된 가상계좌의 은행 코드가 리턴 됩니다.
가상계좌 발급 은행코드 를 참고 바랍니다.
ex) "bankcode":"BK03"

string 20

bankname success

가상계좌 발급 은행 명입니다. 은행 명은 가상계좌 발급 은행코드 를 참고 바랍니다.
ex) "bankname":"기업은행"

string 20

account success

발급된 가상계좌 번호입니다.
ex) "account":"48000000000768"

string 14

app_time success

가상계좌 발급시각입니다.
ex) "app_time":"20240617151535"

string 14

va_date success

가상계좌 입금 마감 일자입니다. YYYYMMDDHHMMSS 형식으로 리턴 됩니다.
ex) "va_date":"20240625235959"

string 1

escw_yn success

에스크로 여부입니다. 에스크로 결제 건일 경우, "Y" 로 리턴 됩니다.
ex) "escw_yn":"N"

string 1

va_receipt_gubn success

현금영수증 등록 여부입니다. 조회된 거래 건의 현금영수증 등록 상태가 리턴 됩니다.
Y : 발급
S : 자진발급
N : 발급안됨
C : 취소
P : 부분취소
ex) "va_receipt_gubn":"Y"

string 1

va_tr_code success

현금영수증 발행 용도입니다.
0 : 소득공제
1 : 지출증빙
ex) "va_tr_code":"1"

string 20

va_taxno success

현금영수증 등록정보 입니다.
현금영수증 발급 용도에 따라 휴대폰번호, 사업자번호 또는 현금영수증 카드번호가 리턴 됩니다.
ex) "va_taxno":"01012345678"

string 4

shop_status success

정산 상태입니다. 거래 건의 정산 상태가 리턴 됩니다. 거래상태 코드 를 참고 바랍니다.
ex) "shop_status":"STSR"

휴대폰 응답

string 14

app_time success

휴대폰 결제 시각 정보입니다. YYYYMMDDHHMMSS 형식으로 리턴됩니다.
ex) "app_time":"20240617151535"

number 12

hp_mny success

휴대폰 결제 금액입니다.
ex) "hp_mny":"5000"

string 3

commid success

휴대폰의 통신사입니다. 통신사코드 를 참고 바랍니다.
ex) "commid":"LGT"

string 16

mobile_no success

휴대폰 번호 입니다. 결제된 휴대폰 번호가 리턴 됩니다.
ex) "mobile_no":"01012345678"

string 4

stat_hp_cd success

최종 결제 상태입니다. 거래상태 코드 를 참고 바랍니다.
ex) "stat_hp_cd":"STSR"

string 4

shop_status success

정산 상태입니다. 거래 건의 정산 상태가 리턴 됩니다. 거래상태 코드 를 참고 바랍니다.
ex) "shop_status":"STSR"

상품권 응답

string 4

tk_van_code success

거래 건의 상품권사 코드입니다. 상품권 코드 를 참고 바랍니다.
ex) "tk_van_code":"SCBL"

string 20

tk_app_no success

상품권 승인번호입니다.
ex) "tk_app_no":"240503055360435"

string 14

tk_app_time success

상품권 승인시간 정보입니다. YYYYMMDDHHMMSS 형식으로 리턴됩니다.
ex) "tk_app_time":"20240617151535"

string 4

shop_status success

정산 상태입니다. 거래 건의 정산 상태가 리턴 됩니다. 거래상태 코드 를 참고 바랍니다.
ex) "shop_status":"STSR"

카카오머니 응답

number 12

kakaomny_mny success

카카오머니 결제 금액입니다.
ex) "kakaomny_mny":"5000"

string 14

app_kakaomny_time success

카카오머니 승인 시간 정보입니다. YYYYMMDDHHMMSS 형식으로 리턴 됩니다.
ex) "app_kakaomny_time":"20240613091423"

number 12

easypoint_rem_mny success

간편결제 거래 건의 취소 가능 금액입니다.
부분취소가 진행되었을 경우, 취소 후 남은 총 결제 금액을 의미합니다.
ex) "easypoint_rem_mny":"5000"

string 4

service_corp_id success

기관 코드입니다. 제휴간편결제 기관 코드 를 참고 바랍니다.
ex) "service_corp_id":"SCKA"

string 4

shop_status success

정산 상태입니다. 거래 건의 정산 상태가 리턴 됩니다. 거래상태 코드 를 참고 바랍니다.
ex) "shop_status":"STSR"

네이버포인트 응답

number 12

naverpoint_mny success

네이버페이 포인트 결제 금액입니다.
ex) "naverpoint_mny":"5000"

string 14

app_easypoint_time success

네이버페이 포인트 승인 시간 정보입니다. YYYYMMDDHHMMSS 형식으로 리턴 됩니다.
ex) "app_easypoint_time":"20240613091423"

number 12

easypoint_rem_mny success

간편결제 거래 건의 취소 가능 금액입니다.
부분취소가 진행되었을 경우, 취소 후 남은 총 결제 금액을 의미합니다.
ex) "easypoint_rem_mny":"5000"

string 14

app_cash_receipt_no success

네이버페이 포인트 결제 건의 현금영수증 거래번호 입니다.
ex) "app_cash_receipt_no":"24415062241991"

string 4

service_corp_id success

기관 코드입니다. 제휴간편결제 기관 코드 를 참고 바랍니다.
ex) "service_corp_id":"SCNA"

string 4

shop_status success

정산 상태입니다. 거래 건의 정산 상태가 리턴 됩니다. 거래상태 코드 를 참고 바랍니다.
ex) "shop_status":"STSR"

토스머니 응답

number 12

tossmny_mny success

토스머니 결제 금액입니다.
ex) "tossmny_mny":"5000"

string 14

app_easypoint_time success

토스머니 승인 시간 정보입니다. YYYYMMDDHHMMSS 형식으로 리턴 됩니다.
ex) "app_easypoint_time":"20240613091423"

number 12

easypoint_rem_mny success

간편결제 거래 건의 취소 가능 금액입니다.
부분취소가 진행되었을 경우, 취소 후 남은 총 결제 금액을 의미합니다.
ex) "easypoint_rem_mny":"5000"

string 4

service_corp_id success

기관 코드입니다. 제휴간편결제 기관 코드 를 참고 바랍니다.
ex) "service_corp_id":"SCTO"

string 4

shop_status success

정산 상태입니다. 거래 건의 정산 상태가 리턴 됩니다. 거래상태 코드 를 참고 바랍니다.
ex) "shop_status":"STSR"

SSG 응답

number 12

ssgmny_mny success

SSG머니 결제 금액입니다.
ex) "ssgmny_mny":"5000"

string 14

app_ssgmny_time success

승인 시간 정보입니다. YYYYMMDDHHMMSS 형식으로 리턴 됩니다.
ex) "app_ssgmny_time":"20240613091423"

number 12

easypoint_rem_mny success

간편결제 거래 건의 취소 가능 금액입니다.
부분취소가 진행되었을 경우, 취소 후 남은 총 결제 금액을 의미합니다.
ex) "easypoint_rem_mny":"5000"

string 4

service_corp_id success

기관 코드입니다. 제휴간편결제 기관 코드 를 참고 바랍니다.
ex) "service_corp_id":"SCSM"

string 4

shop_status success

정산 상태입니다. 거래 건의 정산 상태가 리턴 됩니다. 거래상태 코드 를 참고 바랍니다.
ex) "shop_status":"STSR"

L포인트 응답

number 12

lpoint_mny success

엘포인트 결제 금액입니다.
ex) "lpoint_mny":"5000"

string 14

app_easypoint_time success

승인 시간 정보입니다. YYYYMMDDHHMMSS 형식으로 리턴 됩니다.
ex) "app_easypoint_time":"20240613091423"

number 12

easypoint_rem_mny success

간편결제 거래 건의 취소 가능 금액입니다.
부분취소가 진행되었을 경우, 취소 후 남은 총 결제 금액을 의미합니다.
ex) "easypoint_rem_mny":"5000"

string 4

service_corp_id success

기관 코드입니다. 제휴간편결제 기관 코드 를 참고 바랍니다.
ex) "service_corp_id":"SCLP"

string 4

shop_status success

정산 상태입니다. 거래 건의 정산 상태가 리턴 됩니다. 거래상태 코드 를 참고 바랍니다.
ex) "shop_status":"STSR"

거래조회

거래조회

Header

Request Body 파라미터

Response 파라미터

문서 목차