에스크로 서비스 안내

에스크로는 온라인 거래에서 NHN KCP가 결제대금을 보관 했다가 고객이 물품을 정상적으로 제공 받으면 가맹점에게 대금을 지급하는 서비스입니다. 가맹점과 고객의 상품 배송, 교환, 환불 과정에서 어느 한쪽의 약속불이행에 대한 거래 사고를 예방하기 위하여 거래대금의 입출금을 NHN KCP가 공정하게 관리하는 보호장치입니다.

에스크로 서비스 가이드는 표준 결제 서비스에 파라미터를 추가하여 연동합니다.
거래등록,결제창 호출, 결제 응답, 상태 변경과 Webhook에서 사용되는 에스크로 파라미터에 대해 안내 드리니 그 외는 표준 결제 가이드를 참고해주세요. 에스크로 서비스는 현금 거래인 계좌이체, 가상계좌 서비스에서 제공됩니다.

에스크로란?

에스크로 서비스는 전자상거래 등에서의 소비자 보호에 관련 법률(이하 '전자상거래법')에 따라 2006년 4월 1일부터 시행되었으며, 2013년 11월 29일부터 에스크로 서비스가 거래금액 제한 없이 소비자가 선택하여 진행 할 수 있도록 변경되었습니다.

에스크로 서비스 의무 적용이 면제 되는 거래는 '신용카드로 재화 등의 대금을 지급하는 거래' , '정보통신망으로 전송되거나
에스크로 사업자가 배송을 확인할 수 없는 재화 등을 구매하는 거래' 등으로 자세한 사항은 전자상거래법 24조 3항을 참조해주시기 바랍니다.

1에스크로 FLOW 이해하기

2거래등록(mobile) 적용하기

2.1 거래등록(mobile) 적용하기

결제창을 호출 하기 전 거래등록을 진행하여 주문데이터를 NHN KCP 서버에 저장하는 단계입니다.
표준 결제 서비스에서 사용하는 기본 파라미터 외의 에스크로 파라미터 escw_used를 추가합니다.

거래등록 API URL (target URL)

Stage : https://stg-spl.kcp.co.kr/std/tradeReg/register
Product : https://spl.kcp.co.kr/std/tradeReg/register 


{
 "site_cd":"T0007",
 "kcp_cert_info" : "-----BEGIN CERTIFICATE-----MIIDgTCCAmmgAwIBAgIHkiG9w0……………
                  fWn5Cay7pJNWXCnw4jIiBsTBa3q95RVRyMEcDgPwugMXPXGBwNoMOOpuQ==-----END CERTIFICATE-----",
 "ordr_idxx":"TEST123456789",
 "good_mny":"1000",
 "good_name":"운동화",
 "pay_method":"ACNT",
 "Ret_URL":"https://쇼핑몰주문처리서버/../return",
 "escw_used":"Y" //에스크로 파라미터
}

3장바구니 설정하기

3.1 장바구니 설정 하기

에스크로 서비스는 고객 결제 후 가맹점이 상품의 배송 시작 등록을 하면 고객이 결제창에 기재한 이메일주소에 상품명, 수량 가격이 기재된 에스크로 배송 메일이 전달됩니다.
메일에 기재된 이 상품정보는 가맹점에서 결제창으로 전달한 장바구니 상품정보 파라미터 값으로 노출됩니다.

3.2 장바구니 상품 정보 파라미터: good_info

good_info는 상품 정보를 seq(상품개수 일련번호)로 카운트 하여 상품 하나의 항목은 RECORD SEPARATOR(char(30)),
각각의 상품 구분은 UNIT SEPARATOR(chr(31))으로 구분합니다.
생성한 good_info는 order_info(주문데이터)에 저장하여 결제창으로 전달합니다. 



function create_goodInfo()
{
        var chr30 = String.fromCharCode(30); //ASCII 코드값 30
        var chr31 = String.fromCharCode(31); //ASCII 코드값 31

        var good_info = "seq=1" + chr31 + "ordr_numb=20060310_0001" + chr31 + "good_name=양말" + chr31 + "good_cntx=2" + chr31 + "good_amtx=1000" + chr30+
        "seq=2" + chr31 + "ordr_numb=20060310_0002" + chr31 + "good_name=신발" + chr31 + "good_cntx=1" + chr31 + "good_amtx=1500" +chr30+
        "seq=3" + chr31 + "ordr_numb=20060310_0003" + chr31 + "good_name=바지" + chr31 + "good_cntx=1" + chr31 + "good_amtx=1000";

        document.order+info.good_info.value = good_info;
        v_frm.submit();
}

3.3 장바구니 개수: bask_cntx

good_info에 생성된 상품정보 개수를 bask_cntx 파라미터로 전달합니다.
seq가 3이라면 bask_cntx도 3이 됩니다.


{
 "bask_cntx" : "3"
}

4결제창 호출 하기

4.1 결제창 호출하기

거래등록이 성공하면 결제창을 호출합니다.
주문정보를 전달하는 order_info 데이터에 에스크로 파라미터를 추가합니다.
파라미터에 대한 자세한 안내는 에스크로 파라미터 안내 에서 확인할 수 있습니다.

4.2 Mobile 결제창 호출

거래등록에서 전달된 PayUrl 주소로 에스크로 파라미터를 추가하여 전달합니다. 


{
 "site_cd:" : "T0007",
 "pay_method" : "ACNT",
 "currency" : "410",
 "shop_name" : "KCP SHOP",
 "Ret_URL" : "https://쇼핑몰주문처리서버/../return",
 "approval_key" : "J9z6rqeRrRIjGoxmPPQtpgcHyKIPdQ/iE35VBPEo1sQ=",
 "PayUrl" : "https://testsmpay.kcp.co.kr/pay/mobileGW.kcp",
 "ordr_idxx" : "TEST123456789",
 "good_name" : "휴대폰",
 "good_mny" : "1000",
 "buyr_name" : "홍길동",
 "buyr_tel2" : "010-1234-1234",
 "quotaopt" : "12",
 "escw_used":"Y",
 "pay_mod":"Y",
 "deli_term":"02",
 "bask_cntx":"3",
 "good_info":"seq=1order_numb=0001good_name=양말good_cntx=2good_amtx=1000seq=2order_numb=0001good_name=양말
                   good_cntx=2good_amtx=100seq=3order_numb=0001good_name=양말good_cntx=2good_amtx=100”,
 "rcvr_name":"홍길동",
 "rcvr_tel1":"02-1234-1234",
 "rcvr_tel2":"010-1234-1234",
 "rcvr_mail":"수취인메일",
 "rcvr_zipx":"157864",
 "rcvr_add1":"서울시 구로구 구로동",
 "rcvr_add2":"A아파트 101동 101호"
}

4.3 PC 결제창 호출


{
 "site_cd:" : "T0007",
 "site_name" : "TEST SITE",
 "pay_method" : "010000000000",
 "ordr_idxx" : "TEST123456789",
 "good_name" : "운동화",
 "good_mny" : "1000",
 "escw_used":"Y",
 "pay_mod":"Y",
 "deli_term":"02",
 "bask_cntx":"3",
 "good_info":"seq=1order_numb=0001good_name=양말good_cntx=2good_amtx=1000seq=2order_numb=0001good_name=양말
                   good_cntx=2good_amtx=100seq=3order_numb=0001good_name=양말good_cntx=2good_amtx=100”,
 "rcvr_name":"홍길동",
 "rcvr_tel1":"02-1234-1234",
 "rcvr_tel2":"010-1234-1234",
 "rcvr_mail":"수취인메일",
 "rcvr_zipx":"157864",
 "rcvr_add1":"서울시 구로구 구로동",
 "rcvr_add2":"A아파트 101동 101호"
}

5결제 결과 처리하기

이후 인증 결과 리턴과 결제 요청은 표준 결제 서비스와 동일합니다.
결제 승인 응답데이터에서 에스크로 데이터가 추가되니 결제 처리 영역을 확인해주세요.

5.1 결제 결과 처리하기

결제 승인에 성공하면 res_cd : 0000 과 함께 결제 수단별 응답데이터가 리턴되며 에스크로 거래건은 에스크로 파라미터 escw_yn가 추가로 전달됩니다.

결제 승인 응답의 자세한 내용은 표준결제 서비스 가이드를 확인해주세요. 


{
 "res_cd":"0000",
 "res_msg":"정상처리",
 "res_en_msg":"processing completed",
 "pay_method":"PABK",
 "tno":"24123456789012",
 "amount":"1000",
 "escw_yn":"Y",
 .
 .
 .
}


6에스크로 상태변경

고객이 결제를 완료하면 가맹점은 거래 건에 대해 상태 변경을 진행합니다.
상품을 발송했을 경우 거래 건의 상태를 배송 시작 단계로 처리해야하며, 고객은 배송안내 메일을 받아 상품이 배송되면 메일상에서 구매확인 및 반품요청을 접수할 수 있습니다.
배송 시작 이후 5일 내에 고객이 구매확인 및 반품요청을 진행하지 않을 경우, NHN KCP가 구매확인 처리합니다.

에스크로 상태변경은 배송 시작, 즉시 취소, 정산 보류, 취소, 발급계좌해지, 구매확인 후 취소/환불로 이루어지며 상태변경의 구분값은 mod_type 으로 처리합니다.
에스크로 거래건을 상태변경하지 않을 경우 대금 정산을 받지 못하니 반드시 처리하시기 바랍니다.

에스크로 상태변경에 대한 파라미터는 에스크로 상태변경 파라미터 를 확인해주세요.

6.1 배송 시작

결제가 정상 승인이 되면 상품을 고객에게 배송하고, 배송 시작으로 에스크로 건을 상태 변경 합니다.
배송 시작 단계에서는 택배사명과 운송장 번호를 입력하며, 자체 배송일 경우 자가배송으로 처리합니다. 


{
 "site_cd":"T0007",
 "kcp_cert_info" : "-----BEGIN CERTIFICATE-----MIIDgTCCAmmgAwIBAgIHkiG9w0……………
                  fWn5Cay7pJNWXCnw4jIiBsTBa3q95RVRyMEcDgPwugMXPXGBwNoMOOpuQ==-----END CERTIFICATE-----",
 "tno":"20240516433552",
 "kcp_sign_data":"pYFi\/bwCn1KWYaKsP4uwMhwwaW…….JTNC1bkhbVhSnqsSNWc9j2J1M2A==",
 "mod_type":"STE1",
 "deli_corp":"자가배송",
 "deli_numb":"0000"
}

6.2 즉시 취소

배송 시작 전의 거래를 취소할 때 사용합니다. 가상계좌의 경우 환불 받을 정보를 입력해주셔야 환불처리가 가능합니다. 


{
 "site_cd":"T0007",
 "kcp_cert_info" : "-----BEGIN CERTIFICATE-----MIIDgTCCAmmgAwIBAgIHkiG9w0……………
                  fWn5Cay7pJNWXCnw4jIiBsTBa3q95RVRyMEcDgPwugMXPXGBwNoMOOpuQ==-----END CERTIFICATE-----",
 "tno":"20240516433552",
 "kcp_sign_data":"pYFi\/bwCn1KWYaKsP4uwMhwwaW…….JTNC1bkhbVhSnqsSNWc9j2J1M2A==",
 "mod_type":"STE2",
 "mod_desc":"단순변심",
 "bank_code":"BK02",                    //가상계좌의 경우 사용
 "refund_account":"12345612123456",     //가상계좌의 경우 사용
 "refund_nm":"홍길동"                   //가상계좌의 경우 사용
}

6.3 정산 보류

배송 시작 이후 고객이 취소 요청을 하거나 에스크로 배송메일에서 반품 요청을 하는 경우 정산 보류로 처리합니다.
이후 환불 처리가 결정되면 취소를 진행합니다. 


{
 "site_cd":"T0007",
 "kcp_cert_info" : "-----BEGIN CERTIFICATE-----MIIDgTCCAmmgAwIBAgIHkiG9w0……………
                  fWn5Cay7pJNWXCnw4jIiBsTBa3q95RVRyMEcDgPwugMXPXGBwNoMOOpuQ==-----END CERTIFICATE-----",
 "tno":"20240516433552",
 "kcp_sign_data":"pYFi\/bwCn1KWYaKsP4uwMhwwaW…….JTNC1bkhbVhSnqsSNWc9j2J1M2A==",
 "mod_type":"STE3"
}

6.4 취소

정산 보류된 거래 건을 취소할 때 진행합니다.
상태 값이 배송 중인 거래 건을 취소할 때 정산 보류와 함께 사용하며 가상계좌의 경우 환불 받을 계좌 정보를 입력해야 환불 처리됩니다.


{
 "site_cd":"T0007",
 "kcp_cert_info" : "-----BEGIN CERTIFICATE-----MIIDgTCCAmmgAwIBAgIHkiG9w0……………
                  fWn5Cay7pJNWXCnw4jIiBsTBa3q95RVRyMEcDgPwugMXPXGBwNoMOOpuQ==-----END CERTIFICATE-----",
 "tno":"20240516433552",
 "kcp_sign_data":"pYFi\/bwCn1KWYaKsP4uwMhwwaW…….JTNC1bkhbVhSnqsSNWc9j2J1M2A==",
 "mod_type":"STE4",
 "mod_desc":"단순변심",
 "bank_code":"BK02",                    //가상계좌의 경우 사용
 "refund_account":"12345612123456",     //가상계좌의 경우 사용
 "refund_nm":"홍길동"                   //가상계좌의 경우 사용
}

6.5 발급계좌해지

발급된 가상계좌를 사용 중지 처리할 때 사용합니다.
이미 입금이 완료된 계좌일 경우 상태 변경이 불가하며, 사용 중지된 계좌는 입금이 불가합니다.


{
 "site_cd":"T0007",
 "kcp_cert_info" : "-----BEGIN CERTIFICATE-----MIIDgTCCAmmgAwIBAgIHkiG9w0……………
                  fWn5Cay7pJNWXCnw4jIiBsTBa3q95RVRyMEcDgPwugMXPXGBwNoMOOpuQ==-----END CERTIFICATE-----",
 "tno":"20240516433552",
 "kcp_sign_data":"pYFi\/bwCn1KWYaKsP4uwMhwwaW…….JTNC1bkhbVhSnqsSNWc9j2J1M2A==",
 "mod_type":"STE5",
 "mod_desc":"단순변심"
}

6.6 구매 확인 후 취소

고객 구매 확인까지 완료된 에스크로 거래건에 대해 취소가 필요할 때 진행합니다.
계좌이체 환불, 가상계좌 환불은 환불 받을 계좌 정보가 추가로 필요하며 취소 요청 2~3일후에 환불 완료 처리됩니다.
구매 확인 후 환불 기능은 NHN KCP와 별도 계약이 필요하니 자세한 사항은 NHN KCP로 문의해주세요. 


{
 "site_cd":"T0007",
 "kcp_cert_info" : "-----BEGIN CERTIFICATE-----MIIDgTCCAmmgAwIBAgIHkiG9w0……………
                  fWn5Cay7pJNWXCnw4jIiBsTBa3q95RVRyMEcDgPwugMXPXGBwNoMOOpuQ==-----END CERTIFICATE-----",
 "tno":"20240516433552",
 "kcp_sign_data":"pYFi\/bwCn1KWYaKsP4uwMhwwaW…….JTNC1bkhbVhSnqsSNWc9j2J1M2A==",
 "mod_type":"STE9",
 "mod_desc_cd":"CA06",
 "sub_mod_type":"STSC",
 "mod_sub_type":"MDSC03"
}

7Webhook

에스크로 거래건이 상태변경이 되면 가맹점의 Webhook URL로 상태변경에 대한 통보를 보내드립니다.
통보 서비스는 배송시작, 즉시 취소, 정산보류, 취소, 구매확인, 구매취소, 발급계좌 해지, 가상계좌 입금, 가상계좌 환불 업무에 해당합니다.



7.1 Webhook URL 설정

NHN KCP 상점관리자에서 등록합니다. URL이 등록되어 있지 않을 경우 통보가 발송되지 않습니다.

NHN KCP 상점관리자 > 기술관리센터 > 웹훅(Webhook)관리 > 웹훅 URL 설정



7.2 Webhook 서버 IP 정보

DescriptionServer Info
NHN KCP 통보 테스트 서버 IP ADDRESS210.122.176.144
NHN KCP 통보 운영 서버 IP ADDRESS 1103.215.144.173 / 103.215.144.174
NHN KCP 통보 운영 서버 IP ADDRESS 2203.238.36.173 / 203.238.36.178


7.3 Webhook DATA

Webhook data는 POST형식으로 전달됩니다.
아래는 배송 시작에 대한 예시이며 자세한 사항은 에스크로 상태변경 Webhook 파라미터 를 참고하시기 바랍니다. 


{
 site_cd = T0007
 tno = 24547455659569
 order_no = TEST202410231729664679135
 tx_cd = TX03
 tx_tm = 20241023161723
 waybill_no = 0000
 waybill_corp = 자가배송
}

8파라미터

에스크로 결제에 대한 추가 파라미터 안내입니다.
표준 결제 서비스의 전체 파라미터는 표준결제 서비스 가이드를 참고해주세요.



거래등록 요청 파라미터(Mobile)

거래등록 응답은 표준 결제 서비스 거래 등록 응답과 동일합니다.

string1

escw_used필수Mobile

에스크로 사용 여부입니다.
Y또는 N으로 처리되며, 에스크로를 진행하실 서비스에만 Y값을 전달해주세요.
에스크로는 현금 결제인 계좌이체, 가상계좌 서비스에만 제공됩니다.
ex) "escw_used" : "Y"

결제창 호출 파라미터

string1

escw_used필수PC / Mobile

에스크로 사용 여부 입니다.
ex) "escw_used":"Y"

string1

pay_mod필수PC / Mobile

에스크로 결제 처리 여부입니다.
escw_used를 Y 로 넘겼어도 pay_mod를 N 으로 넘기면 일반결제로 처리됩니다.
에스크로 결제 처리 : Y , 일반 결제처리 : N
ex) "pay_mod" : "Y"

number2

deli_term필수PC / Mobile

예상되는 배송 소요일입니다.
3일이 예상될 경우 3이라고 입력합니다. 숫자 2자리로 사용됩니다.
ex) "deli_term" : "3"

string30

rcvr_namePC / Mobile

수취인 명입니다.
ex) "rcvr_name" : "김케이"

string20

rcvr_tel1PC / Mobile

수취인 전화번호입니다.
ex) "rcvr_tel1" : "02-1234-1234"

string20

rcvr_tel2PC / Mobile

수취인 휴대폰 번호입니다.
ex) "rcvr_tel2" : "010-1234-1234"

string20

rcvr_mailPC / Mobile

수취인 이메일 주소입니다.
ex) "rcvr_mail" : "이메일주소"

string6

rcvr_zipxPC / Mobile

수취인 우편 번호입니다.
ex) "rcvr_zipx" : "01853"

string100

rcvr_add1PC / Mobile

수취인 주소입니다.
ex) "rcvr_add1" : "서울시 구로구 구로동"

string100

rcvr_add2PC / Mobile

수취인 상세주소입니다.
ex) "rcvr_add2" : "0번지 1층"

string2

bask_cntxPC / Mobile

장바구니에 담긴 상품 개수입니다.
good_info 값에 담긴 상품 개수와 동일하게 입력합니다. 예를 들어 seq가 3개일 경우 3으로 입력합니다.
최대 허용 개수는 40개 입니다.
ex) "bask_cntx" : "3"

string가변

good_infoPC / Mobile

장바구니의 상품 정보 입니다.
한 상품에 대한 주문 번호, 이름, 수량 금액 항목을 입력합니다.

상품 구분은 RECORD SEPARATOR (chr(30))으로 구분하며, 상품의 항목들은 UNIT SEPARATOR (chr(31))으로 구분합니다.

ex) "good_info" :
"seq=1" + chr31 + "ordr_numb=TEST123456789" + chr31+ "good_name=양말" + chr31 + "good_cntx=2" + chr31 + "good_amtx=1000" + chr30 +
"seq=2" + chr31 + "ordr_numb=TEST123456789" + chr31+ "good_name=신발" + chr31 + "good_cntx=1" + chr31 + "good_amtx=1500" + chr30 +
"seq=3" + chr31 + "ordr_numb=TEST123456789" + chr31+ "good_name=바지" + chr31 + "good_cntx=1" + chr31 + "good_amtx=1000";

항목 명상품 정보길이
seq상품개수 일련번호2
ordr_numb상품 주문번호40
good_name상품 이름30
good_cntx상품 수량2
good_amtx상품 금액12

에스크로 승인 응답 파라미터

에스크로 결제에 대한 추가 파라미터 안내입니다.
표준결제에서 사용하는 전체 파라미터는 표준결제 서비스 를 참고해주세요.
승인 요청 전문은 표준 결제 서비스와 동일합니다.

string1

escw_ynPC / Mobile

에스크로 결제 여부 입니다.
Y 또는 N으로 응답되며 에스크로 결제건은 Y로 응답됩니다.
ex) "escw_yn" : "Y"

에스크로 상태변경 요청 파라미터

공통 파라미터

string5

site_cd필수PC / Mobile

길이가 5자리로 영문대문자 또는 영문대문자 + 숫자로 구성됩니다. 모든 서비스에 사용합니다.
ex) "site_cd" : "T0007"

string가변

kcp_cert_info필수PC / Mobile

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

string가변

kcp_sign_data필수PC / Mobile

서명데이터입니다.
NHN KCP로부터 발급받은 개인키 (PRIVATE KEY)로 SHA256withRSA 알고리즘을 사용하여 문자열을 인코딩하는 방식으로 이루어집니다.
site_cd+"^"+tno+"*"+mode_type 조합으로 생성합니다.
ex) "kcp_sign_data" : "ceCJUAwjijT7+VKVt+...P6wPmg=="

string14

tno필수PC / Mobile

상태를 변경할 에스크로 거래건의 거래번호입니다.
ex) "tno" : "24822014611200”

string4

mod_type필수PC / Mobile

상태변경 구분값입니다.
ex) "mod_type" : "STE1"

상태값
배송시작STE1
즉시취소(배송 전 취소)STE2
정산보류STE3
취소(배송 후 취소)STE4
발급계좌해지
(가상계좌의 경우에만 사용)		STE5
계좌이체 구매 확인 후 취소
계좌이체 구매 확인 후 부분취소
계좌이체 구매 확인 후 환불
가상계좌 구매 확인 후 환불
가상계좌 구매 확인 후 부분환불		 STE9
string15

mod_ipPC / Mobile

상태변경 요청 IP입니다.
ex) "mod_ip" : "0.0.0.1"

배송시작 요청 파라미터

string25

deli_corpMobile

배송업체 명입니다.
택배사를 이용하지 않을 경우, 임의의 값으로 입력합니다.
배송시작 상태변경에서 필수값입니다.
ex) "deli_corp" : "자가배송"

string50

deli_numbMobile

택배 송장번호 입니다.
배송시작 상태변경에서 필수값입니다. 택배사를 이용하지 않을 경우 임의의 값으로 입력합니다.
ex) "deli_numb" : "0000"

즉시취소/취소 상태변경 파라미터

string100

mod_descPC / Mobile

취소 사유입니다.
ex) "mod_desc" : "단순변심”

string4

bank_codePC / Mobile

환불 계좌의 은행코드입니다.
즉시취소(STE2) / 취소(STE4) 요청에서 가상계좌 거래일 경우 사용합니다.
ex) "bank_code" : "BK03”

string20

refund_accountPC / Mobile

환불 계좌번호입니다.
즉시취소(STE2) / 취소(STE4) 요청에서 가상계좌 거래일 경우 사용합니다.
ex) "refund_account" : "11025123456”

string50

refund_nmPC / Mobile

환불 계좌의 예금주명입니다.
즉시취소(STE2) / 취소(STE4) 요청에서 가상 계좌 거래일 경우 사용합니다.
ex) "refund_nm" : "홍길동"

구매 확인 후 상태변경 추가 파라미터

string4

mod_desc_cdPC / Mobile

취소 사유에 대한 코드로 고정값 CA06이 사용됩니다.
ex) "mod_desc_cd" : "CA06"

string4

sub_mod_typePC / Mobile

상태변경 유형입니다.
구매확인 후 취소, 부분 취소, 환불, 부분 환불시 사용합니다.
계좌이체 전체 취소 -STSC
계좌이체 부분 취소 -STPC
계좌이체, 가상계좌 전체환불 - STHD
가상계좌 부분 환불 - STPD
ex) "sub_mod_type" : "STSC"

string6

mod_sub_typePC / Mobile

구매확인 된 거래의 상태변경에 대한 추가 보조 유형입니다.
가상계좌 전체 환불 -MDSC00
계좌이체 전체 취소 -MDSC03
가상계좌 부분환불 / 계좌이체 부분 취소 / 계좌이체 전체 환불 - MDSC04
ex) "mod_sub_type" : "MDSC00"

string1

part_canc_ynPC / Mobile

부분 취소 사용에 대한 파라미터입니다.
계좌이체 구매확인 후 부분 취소, 가상계좌 구매확인 후 부분 환불 요청시 전달합니다.
ex) "part_canc_yn" : "Y"

number9

mod_mnyPC / Mobile

부분 취소 요청 금액입니다.
계좌이체 구매 확인 후 부분 취소, 가상계좌 구매 확인 후 부분 환불 요청 시 전달합니다.
ex) "mod_mny" : "500"

number9

rem_mnyPC / Mobile

부분 취소 가능 금액입니다.
계좌이체 구매 확인 후 부분 취소, 가상계좌 구매 확인 후 부분 환불 요청 시 전달합니다.
ex) "rem_mny" : "1000"

string4

mod_bankcodePC / Mobile

환불 계좌의 은행 코드 입니다.
계좌이체 전체환불(MDSC04), 가상계좌 전체환불(MDSC00)/부분환불(MDSC04)에서 사용합니다.
ex) "mod_bankcode" : "BK03"

string20

mod_accountPC / Mobile

환불 계좌번호 입니다.
계좌이체 전체환불(MDSC04), 가상계좌 전체환불(MDSC00)/부분환불(MDSC04)에서 사용합니다.
ex) "mod_account" : "11025123456"

string30

mod_depositorPC / Mobile

환불 계좌의 예금주명입니다.
계좌이체 전체환불(MDSC04), 가상계좌 전체환불(MDSC00)/부분환불(MDSC04)에서 사용합니다.
ex) "mod_depositor" : "홍길동"

string4

tax_flagPC / Mobile

복합과세 거래 구분값입니다.
부분취소 및 부분환불 진행 시, 복합과세 거래 건 일 경우 사용합니다.
고정값: TG03
ex) "tax_flag" : "TG03"

number9

mod_free_mnyPC / Mobile

부분취소, 부분환불 금액의 비과세액입니다.
mod_mny (부분취소 요청금액)의 비과세 금액을 입력합니다.
ex) "mod_free_mny" : "100"

number9

mod_tax_mnyPC / Mobile

부분취소, 부분환불 금액의 공급가액입니다.
mod_mny 값이 500원이라면 비과세를 제외한 금액의 공급가액을 입력합니다.
ex) "mod_tax_mny" : "363"

number9

mod_vat_mnyPC / Mobile

부분취소, 부분환불 금액의 부가세입니다.
mod_mny 값이 500원이라면 비과세를 제외한 금액의 부가세를 입력합니다.
ex) "mod_vat_mny" : "37"

에스크로 상태변경 응답 파라미터

string4

res_cdPC / Mobile

상태 변경에 대한 결과 코드입니다.
정상 처리시 '0000'이 리턴됩니다.
ex) "res_cd" : "0000"

string100

res_msgPC / Mobile

상태 변경에 대한 결과 메시지 입니다.
정상 처리시 '정상처리' 로 응갑됩니다.
ex) "res_msg" : "정상처리"

에스크로 상태변경 Webhook 파라미터

공통 파라미터

string4

site_cdPC / Mobile

NHN KCP에서 발급된 가맹점 사이트코드입니다.
ex) "site_cd" : "T0007"

string14

tnoPC / Mobile

NHN KCP 고유 거래번호입니다.
ex) "tno" : "24123456789012"

string40

order_noPC / Mobile

가맹점에서 생성한 주문번호입니다.
ex) "order_no" : "TEST123456789"

string4

tx_cdPC / Mobile

상태변경의 업무 구분 코드입니다.
ex) "tx_cd" : "TX03"

상태코드
가상계좌 입금TX00
가상계좌 환불TX01
구매확인/구매취소TX02
배송시작TX03
정산보류TX04
즉시취소TX05
취소TX06
발급계좌해지TX07

string14

tx_tmPC / Mobile

통보된 업무의 처리 완료시간입니다.
YYYYMMDDhhmmss 형식으로 전달됩니다.
ex) "tx_tm" : "20240131235959"


가상계좌 입금 파라미터

string30

ipgm_namePC / Mobile

주문자명입니다.
입금자와 주문자는 다를 수 있습니다.
ex)"ipgm_name" : "홍길동"

number9

ipgm_mnyxPC / Mobile

가상계좌 입금 금액입니다.
ex) "ipgm_mnyx" : "1000"

number9

totl_mnyxPC / Mobile

가상계좌에 입금된 금액합계입니다.
ex) "totl_mnyx" : "1000"

string14

ipgm_timePC / Mobile

가상계좌 입금 시각입니다.
YYYYMMDDhhmmss 형식으로 전달됩니다.
ex) "ipgm_time" : "20240131235959"

string2

bank_codePC / Mobile

가상계좌 은행코드입니다.
ex) "bank_code" : "03"

string20

accountPC / Mobile

입금된 가상계좌번호입니다.
ex) "account" : "56201234123412"

string20

noti_idPC / Mobile

가상계좌의 각 입금 통보 건에 대한 고유값입니다.
ex) "noti_id" : "24013112345678901234"

string2

op_cdPC / Mobile

가상계좌 입금에 대한 결과 구분 코드입니다.
입금건에 대해 은행의 망취소가 진행될 경우 '13'으로 응답됩니다.
'13'으로 응답시 입금과 망취소에서 동일한 noti_id로 발송되니 취소 처리에 참고하시기 바랍니다.
ex) "op_cd" : "50"

string30

remitterPC / Mobile

가상계좌 입금자명입니다.
주문자명과 다를 수 있습니다.
ex) "remitter" : "홍길동"

string9

cash_a_noPC / Mobile

현금영수증 승인번호입니다.
ex) "cash_a_no" : "591234567"

string14

cash_noPC / Mobile

현금영수증 거래번호입니다.
ex) "cash_no" : "24123456789012"


가상계좌 환불 통보 파라미터

string30

refund_nmPC / Mobile

환불 계좌의 예금주명입니다.
ex)"refund_nm" : "홍길동"

number9

refund_mnyPC / Mobile

환불 금액입니다.
ex)"refund_mny" : "1000"

string4

bank_codePC / Mobile

환불 계좌 은행코드입니다.
ex)"bank_code" : "BK03"


배송시작 통보 파라미터

string50

waybill_noPC / Mobile

택배 운송장 번호입니다.
ex)"waybill_no" : "00121112525"

string50

waybill_corpPC / Mobile

택배사명입니다.
ex)"waybill_corp" : "OO택배"


구매확인 통보 파라미터

string1

st_cdPC / Mobile

구매확인 구분코드입니다.
구매확인: Y, 반품요청: N, 시스템 구매확인: S
(시스템 구매확인: 배송시작 상태 변경 후 5일 내에 구매확인이 이루어지지 않았을 경우 NHN KCP에서 자동으로 구매확인 처리합니다.)
ex)"st_cd" : "Y"

string50

can_msgPC / Mobile

반품 사유입니다.
ex)"can_msg" : "상품불량"

목차