자동결제 서비스 연동하기

NHN KCP 자동결제(빌링)는 사용자의 카드 정보로 배치키를 발급 받고, 배치키로 결제 주기에 따라 결제 요청하는 서비스입니다.
일회성 결제는 매 시도에서 고객의 인증이 필요하지만, 자동결제는 처음 배치키 발급에서만 고객 인증이 진행되고 이후에는 인증절차 없이 가맹점의 요청에 따라 결제가 이루어집니다. 정기 배송, 정기 구독 등의 서비스에 사용되며 별도 계약이 필요한 서비스입니다

1서비스 FLOW 이해하기

NHN KCP 자동결제(빌링)는 배치키 발급과 결제의 프로세스로 이루어집니다.
배치키란 카드 인증정보를 암호화한 값이며, 결제창에서 고객의 카드정보 입력과 본인확인이 정상처리 되었을 경우 가맹점으로 리턴됩니다.
리턴받은 배치키는 결제 주기에 맞춰 원하는 금액으로 결제요청합니다

2서비스 인증서 준비

2.1 서비스 인증서가 필요한 이유

NHN KCP 가맹점임을 NHN KCP 결제서버에서 인지하기 위한 인증서입니다.
NHN KCP 에서는 NHN KCP 결제를 이용하기 위해 결제서비스 인증서 (이하 서비스 인증서로 표기)를 발급하고, 결제 및 취소 요청시 NHN KCP가 발급한 서비스 인증서로 통신을 하도록 규정하였습니다.

2.2 서비스 인증서 발급 방법

NHN KCP 표준 결제서비스 연동을 위해 KCP PG-API 서비스 인증서와 개인키를 NHN KCP 상점관리자에서 발급 받습니다.
서비스 인증서에 대한 자세한 사항은 서비스 인증서 메뉴에서 확인할 수 있습니다.

2.3 서비스 인증서 적용방법

서비스 인증서는 발급받은 서비스 인증서 파일을 에디트하여 직렬화를 하고, 해당 값을 아래와 같이 kcp_cert_info 값에 적용합니다.
개인키 파일은 파일 자체를 관리하는 서버에 저장하고, 해당 경로를 지정합니다. 


kcp_cert_info = "-----BEGIN CERTIFICATE-----MIIDgTCCAmmgAwIBAgIHkiG9w0……………
                          fWn5Cay7pJNWXCnw4jIiBsTBa3q95RVRyMEcDgPwugMXPXGBwNoMOOpuQ==-----END CERTIFICATE-----";

filePath = "C:\....\splPrikeyPKCS8.pem";

3거래등록하기

배치키 발급 요청의 첫번째 단계는 거래등록입니다.
배치키 발급에 필요한 주문데이터를 NHN KCP 서버에 먼저 등록한 후, 결제창을 호출합니다.

3.1 거래등록(Mobile) 적용하기

배치키 발급의 필수 주문 정보인 ordr_idxx, good_mny, pay_method, Ret_URL 파라미터의 값은 반드시 가맹점 서버에 저장하여 사용해주시기 바랍니다.
자세한 거래등록 파라미터는 거래등록 파라미터 안내 에서 확인할 수 있습니다.

거래등록 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"         : "A52Q7",
 "kcp_cert_info"   : "-----BEGIN CERTIFICATE-----MIIDgTCCAmmgAwIBAgI……………
                          fWn5Cay7pJNWXCnw4jIiBsTBa3q95RVRyMEcDgPwugMXPXGBwNoMOOpuQ==-----END CERTIFICATE-----",
 "ordr_idxx"       : "TEST123456789",
 "good_mny"        : "1000",
 "good_name"       : "운동화",
 "pay_method"      : "AUTH",
 "Ret_URL"         : "https://쇼핑몰주문처리서버/../return"
}

3.2 거래등록 응답

거래등록이 정상처리 되면 암호화된 인증키(approvalKey) 와 결제창 호출 주소(PayUrl) 가 리턴됩니다. NHN KCP 에서 리턴받은 그대로 사용해주시기 바랍니다.


{
 "Code"          : "0000",
 "Message"       : "Success",
 "approvalKey"   : "22FGfTwobj56+hIL4D3TUAcHyKIPdQiE35VBPEo1cQ=",
 "PayUrl"        : "https://testsmpay.kcp.co.kr/pay/mobileGW.kcp",
 "paymentMethod" : "AUTH",
 "hashData"      : "b90068af23445eea0ac58fc725fe36756836e80a172fc78a8097b99f5317004b",
 "traceNo"       : "A52Q7LVLYR6POLDZ"
}

4결제창 호출하기

4.1 Mobile 버전

거래 등록이 성공되었다면 결제창을 호출합니다.
거래 등록에서 리턴된 PayUrl 주소로 주문정보들을 order_info 에 담아 form 형태로 전달해주시기 바랍니다.
거래 등록의 데이터와 order_info 데이터가 다를 경우 결제창에서 오류를 리턴합니다.
PayUrl 은 리턴된 그대로 사용해주시기 바랍니다. (수정불가)

결제 수단 별 결제 요청 파라미터는 결제요청 파라미터 안내에서 확인할 수 있습니다.

모바일 결제창에서는 good_mny 가 사용되지만 입력한 금액으로 결제가 되는 것은 아닙니다. 배치키 발급 이후, 결제요청 때에 요청한 금액으로 결제가 이루어집니다.


{
 "site_cd":"A52Q7",
 "pay_method":"AUTH",
 "currency":"410",
 "shop_name":"TEST SITE",
 "ActionResult":"batch",
 "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",
 "kcp_group_id":"A52Q71000489"
}
                        


  function call_pay_form()
  {
        var v_frm = document.order_info;
        var PayUrl = v_frm.PayUrl.value;
        v_frm.action = PayUrl.substring(0,PayUrl.lastIndexOf("/")) +"/jsp/encodingFilter/encodingFilter.jsp";              
        v_frm.submit();
  }

4.2 PC 버전

PC 결제창은 거래등록 없이 KCP_Pay_Execute_Web 메서드에 order_info 를 전달합니다.

PC 결제창은 JS 스크립트를 이용해 결제창을 호출합니다.

Stage : https://testspay.kcp.co.kr/plugin/kcp_spay_hub.js
Product : https://spay.kcp.co.kr/plugin/kcp_spay_hub.js 


<script type="text/javascript" src="https://testspay.kcp.co.kr/plugin/kcp_spay_hub.js"></script>

PC 결제창 호출 함수 jsf__pay
KCP_Pay_Execute_Web 를 통해 결제창 호출.


function jsf__pay( form )
{
    try
    {
        KCP_Pay_Execute_Web( form );    // 결제창 호출 메서드
    }
    catch (e)
    {
        /* 브라우저에서 결제 정상종료시 throw로 스크립트 종료 */
    }
 }

4.3 결제창 호출시 전달하는 기본 정보

모바일 결제창 전달정보


<form name="order_info" method="post" action="승인요청URL">
{
 "site_cd":"A52Q7",
 "pay_method":"AUTH",
 "currency":"410",
 "shop_name":"TEST SITE",
 "kcp_group_id":"A52Q71000489",
 "ActionResult":"batch",
 "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"
}

PC 결제창 전달정보


<form name="order_info" method="post" action="승인요청URL">

{
 "site_cd":"A52Q7",
 "card_cert_type":"BATCH",
 "site_name":"TEST SITE",
 "pay_method":"AUTH:CARD",
 "kcpgroup_id":"A52Q71000489",
 "ordr_idxx":"TEST123456789",
 "good_expr":"2:1m",
 "batch_soc":"Y",
 "module_type":"01",
 "ordr_idxx":"TEST123456789",
 "buyr_name":"홍길동"
}

5결제창 인증결과

결제창 인증이 완료되면 최초 거래등록에서 넘긴 파라미터에 대한 결과가 Ret_URL 로 전달됩니다.
결제창에서 리턴된 데이터는 form 형식으로 전달되며 인증데이터를 암호화한 enc_info, enc_data가 전달됩니다.

PC 버전은 m_Completepayment 콜백 함수를 통해 enc_info, enc_data 가 리턴됩니다.
enc_info, enc_data는 전달받은 그대로 사용해주시기 바랍니다. 


{
 "res_cd":"0000",
 "res_msg":"정상처리",
 "tran_cd":"00300001",
 "enc_data":"SnvXdGftIEjAequorkpNhJXc4u3GRuotLHW9vyDDOhdeorM4DPXMJgJlIEoRo6divo=",
 "enc_info":"3dsgjljlsSEGHsdccndsgnfdSDDhhbdrhffRbdfRYHFgfgnb=_"
}

6배치키 발급요청

Ret_URL로 전달받은 인증 결과데이터를 API 통신으로 배치키요청 하는 단계입니다.
승인 요청 데이터는 NHN KCP의 API URL로 json string 형태로 전송하시기 바랍니다.
배치키 발급요청 파라미터는 배치키 발급요청 파라미터 안내에서 확인할 수 있습니다.

배치키 발급요청 API URL (target URL)

Stage : https://stg-spl.kcp.co.kr/gw/enc/v1/payment
Product : https://spl.kcp.co.kr/gw/enc/v1/payment 


{
 "tran_cd":"00300001",
 "kcp_cert_info" : "-----BEGIN CERTIFICATE-----MIIDgTCCAmmgAwIBAgIHkiG9w0……………
                          fWn5Cay7pJNWXCnw4jIiBsTBa3q95RVRyMEcDgPwugMXPXGBwNoMOOpuQ==-----END CERTIFICATE-----",
 "site_cd":"A52Q7",
 "enc_data":"SnvXdGftIEjAequorkpNhJXc4hfghdfs5dfsgu3GRuotLHW9vyDDOhdeorM4DPXMJgJlIEoRo6divo=",
 "enc_info":"3dsgjljlsSEGHsdccndsgnfdSDDhhbdrhffRbdfRYHFgfgnb=_"
}

7배치키 발급응답

배치키 발급요청이 정상처리되었을 경우 res_cd : 0000 과 함께 배치키 정보가 리턴됩니다.
배치키는 별도 조회할 수 있는 기능이 없으니 발급된 배치키는 관리에 유의해주시기 바랍니다. 


{
 "res_cd":"0000",
 "res_msg":"정상처리",
 "card_name":"삼성카드",
 "batch_key" : "24010124040463F4",
 "card_cd":"CCSS",
 "card_bin_type_01":"0",
 "card_bin_type_02":"0"
}

8결제요청

결제에 필요한 주문정보와 발급받은 배치키로 결제주기에 맞춰 결제 요청을 합니다.
결제 요청의 bt_group_id는 배치키 발급단계에서 사용한 그룹아이디와 동일한 값을 사용하시기 바랍니다.

결제요청 API URL (target URL)

Stage : https://stg-spl.kcp.co.kr/gw/hub/v1/payment
Product : https://spl.kcp.co.kr/gw/hub/v1/payment 


{
 "kcp_cert_info" : "-----BEGIN CERTIFICATE-----MIIDgTCCAmmgAwIBAgIHkiG9w0……………
                          fWn5Cay7pJNWXCnw4jIiBsTBa3q95RVRyMEcDgPwugMXPXGBwNoMOOpuQ==-----END CERTIFICATE-----",
 "site_cd":"A52Q7",
 "pay_method":"CARD",
 "amount":"1000",
 "card_mny":"1000",
 "quota":"00",
 "currency":"410",
 "ordr_idxx":"TEST123456789",
 "good_name":"운동화",
 "buyr_name":"홍길동",
 "card_tx_type":"11511000",
 "bt_batch_key":"24010124040463F4",
 "bt_group_id":"A52Q71000489"
}

9결제결과 처리하기

결제 승인에 성공하면 res_cd : 0000 과 함께 결제수단별 응답 파라미터가 리턴됩니다.
res_data를 확인하셔서 결제수단별 결과값들을 가맹점 서버에 저장하셔서 관리하시길 바랍니다.
자세한 응답 파라미터는 결제 응답 파라미터에서 확인할 수 있습니다. 


//신용카드 응답 데이터 예시
{
 "res_cd":"0000",
 "res_msg":"정상처리",
 "pay_method":"PACA",
 "order_no":"TEST123456789",
 "amount":"1000",
 "card_mny":"1000",
 "coupon_mny":"0",
 "card_no":"4673090000000032",
 "quota":"00",
 "tno":"24346915432487",
 "card_cd":"CCKM",
 "card_name":"국민카드",
 "app_no":"78710726"
}

10배치키 삭제 안내

구독을 중지하거나 신용카드 변경 등으로 기존의 배치키를 사용하지 않을 경우, 배치키를 삭제할 수 있습니다.
삭제 요청 후 정상 처리 되었을 경우, res_cd : 0000 이 리턴됩니다.

배치키 삭제요청 API URL (target URL)

Stage : https://stg-spl.kcp.co.kr/gw/hub/v1/payment
Product : https://spl.kcp.co.kr/gw/hub/v1/payment 


{
 "kcp_cert_info" : "-----BEGIN CERTIFICATE-----MIIDgTCCAmmgAwIBAgIHkiG9w0……………
                          fWn5Cay7pJNWXCnw4jIiBsTBa3q95RVRyMEcDgPwugMXPXGBwNoMOOpuQ==-----END CERTIFICATE-----",
 "site_cd":"A52Q7",
 "pay_method":"BATCH",
 "tx_type":"10005010",
 "group_id":"A52Q71000489",
 "batch_key":"24010124040463F4"
}

11파라미터

Mobile 과 PC 파라미터가 상이할 수 있어요.
전용 파라미터는 mobile 또는 PC로 표기되어 있습니다.



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

string5

site_cd필수Mobile

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

string가변

kcp_cert_info필수 Mobile

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

string40

ordr_idxx필수Mobile

상점에서 관리하는 주문번호입니다. 중복되지 않는 유니크한 값으로 사용하시길 권장합니다.
주문 데이터 관리를 위해 가맹점에서 반드시 저장해야합니다.
ex) "ordr_idxx" : "TEST123456789"

number9

good_mny필수Mobile

결제 금액입니다. 콤마와 같은 특수문자는 사용이 불가합니다.
ex) "good_mny" : "1000"

string4

pay_method필수Mobile

결제수단 코드 값 입니다.
pay_method : AUTH

string100

good_name필수Mobile

상품명입니다.
ex) "good_name" : "운동화"

string256

Ret_URL필수Mobile

인증 완료 후 데이터를 리턴받을 응답 주소
ex) "Ret_URL" : "https://쇼핑몰주문처리서버/../return"

string40

user_agentMobile

단말기 OS
ex) "user_agent" : "Android"

거래등록 응답 파라미터(Mobile)

string4

CodeMobile

응답코드 정상인 경우 0000 리턴됩니다.
ex) "Code":"0000"

string100

MessageMobile

응답 메세지입니다.
ex) "Message" : "Success"

string가변

approvalKeyMobile

거래 인증 키입니다.
ex) "approvalKey" : "ockLyC3QHxD5rSUio3ETuAcHyKIPdQiE35VBPEo1cQ=",

string가변

PayUrlMobile

리턴 받은 결제 창 호출 주소.전달 받은 값 그대로 요청 합니다.
ex) "PayUrl" : "https://testsmpay.kcp.co.kr/pay/mobileGW.kcp",

string가변

hashDataMobile

거래등록 해쉬 정보입니다.
ex) "hashData" : "cn441e70e7332cab403aq9d8ad6b7d40ba399bf84a80e78a93b3b27f6736653bb"

string가변

traceNoMobile

추적번호 입니다.
ex) "traceNo" : "T0000LVVWE89WYDC"

string4

paymentMethodMobile

결제수단 입니다.
ex) "paymentMethod" : "AUTH"

string가변

request_URIMobile

요청주소 입니다.

결제창 호출 파라미터

string5

site_cd필수PC / Mobile

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

string412

pay_method필수PC / Mobile

MOBILE 결제수단 코드 값 입니다. (4 Byte)
Mobile - "pay_method" : "AUTH"
PC - "pay_method" : "AUTH:CARD"

string가변

PayUrl필수Mobile

결제창 호출 주소.
거래등록에서 전달받은 그대로 사용해주세요
ex) TEST일 경우, "PayUrl" : "https://testsmpay.kcp.co.kr/pay/mobileGW.kcp"

string가변

approval_key필수Mobile

거래 인증 키
(거래등록 후 리턴받은 approvalKey 값을 셋팅해주세요. )
ex) "approval_Key" : "ockLyC3QHxD5rSUio3ETuAcHyKIPdQiE35VBPEo1cQ="

string256

Ret_URL필수Mobile

리다이렉트 URL
인증결과를 리턴받을 가맹점의 URL
ex) "Ret_URL" : "https://쇼핑몰주문처리서버/../return"

string가변

AppUrlMobile

가맹점 APP 호출 URL
가맹점에서 APP으로 연동 시, 타 APP에서 가맹점 APP을 다시 호출하기 위한 값 ( 가맹점 APP 연동 시 필수 )
ex) "AppUrl" : "myapp://"

string40

ordr_idxx필수PC / Mobile

상점에서 관리하는 주문번호입니다. 중복되지 않는 유니크한 값으로 사용하시길 권장합니다.
주문 데이터 관리를 위해 가맹점에서 반드시 저장해야합니다.
ex) "ordr_idxx" : "TEST123456789"

number9

good_mny필수PC / Mobile

결제 금액입니다.
ex) "good_mny" : "1000"

string100

good_name필수PC / Mobile

상품명입니다. 최대길이는 100자입니다.
ex) "good_name" : "운동화"

string3

currency필수PC / Mobile

화폐단위
※ Mobile 원화 - 410
※ PC 원화 - WON
ex) 모바일의 경우, "currency" : "410"

string4

ActionResultMobile

인증방식(영문소문자)으로 배치키 발급의 경우 batch(고정)입니다.
ActionResult : batch

string20

shop_nameMobile

사이트명
ex) "shop_name" : "NHN KCP SHOP"

string20

site_namePC

상점이름(영문으로 작성권장)
ex) "site_name" = "NHN KCP"

string30

buyr_namePC / Mobile

주문자이름
ex) "buyr_name" : "홍길동"

string12

kcp_group_id필수Mobile

자동결제 그룹 아이디이며, 배치키 발급 및 승인 시 그룹별로 관리할 수 있습니다.
ex) "kcp_group_id" : "A52Q71000348"

※ 자동결제 그룹 아이디 생성 방법
NHN KCP 상점관리자 → 결제 관리 → 자동결제 → 그룹관리를 통해 그룹 아이디 생성

string12

kcpgroup_id필수PC

자동결제 그룹 아이디이며, 배치키 발급 및 승인 시 그룹별로 관리할 수 있습니다.
ex) "kcpgroup_id" : "A52Q71000348"

※ 자동결제 그룹 아이디 생성 방법
NHN KCP 상점관리자 → 결제 관리 → 자동결제 → 그룹관리를 통해 그룹 아이디 생성

string5

card_cert_typePC

인증방식으로 배치키 발급의 경우 BATCH(고정)입니다.
ex) "card_cert_type" : "BATCH"

string2

module_typePC

결제창 설정 정보입니다. 01 의 고정값을 사용합니다.
ex) "module_type" : "01"

string1

batch_socPC

NHN KCP 결제창 내에서 생년월일 사용값으로, Y로 고정값 입니다.
ex) "batch_so" : "Y"

string가변

good_exprPC

NHN KCP 결제창에 노출되는 제공기간 설정 변수입니다.
해당 값을 설정하지 않는 경우, 결제창에서 [자동결제]로 노출됩니다.
ex) "good_expr" : "2:1m" -> [1개월 자동결제]로 표기

string1

batch_soc_choicePC / Mobile

NHN KCP 결제창에서 주민번호/사업자번호를 설정합니다.
S : 주민번호만 표기
C: 사업자번호만 표기
ex) "batch_soc_choice" : "S"

string1

batch_cardno_return_ynPC / Mobile

배치키 발급 시 사용한 카드의 카드번호의 리턴여부를 설정합니다.
Y : 123412******1234 형식
L : 1234
ex) "batch_cardno_return_yn" : "Y"

string4

kcp_restricted_cardPC / Mobile

특정카드에 대해 배치키 발급을 제한할 수 있습니다.
CK01 = 신용카드(Credit Card)
CK02 = 체크카드(Debit Card)
CK03 = 구매카드(Pre-paid Card)
CK04 = 기프트카드(Gift Card)
ex) "kcp_restricted_card" : "CK02" // 체크카드 배치키 발급제한

string1000

param_opt_1 Mobile

NHN KCP 기본 파라미터 외 업체 추가 파라미터입니다.
ex) "param_opt_1" : "test"

string1000

param_opt_2 Mobile

NHN KCP 기본 파라미터 외 업체 추가 파라미터입니다.
ex) "param_opt_2" : "test"

string1000

param_opt_3 Mobile

NHN KCP 기본 파라미터 외 업체 추가 파라미터입니다.
ex) "param_opt_3" : "test"

결제창 인증 응답 파라미터

string4

res_cdPC / Mobile

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

string100

res_msgPC / Mobile

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

string5

site_cdMobile

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

string가변

enc_dataPC / Mobile

결제창 인증결과 암호화 정보
통합 결제 창으로부터 전달 받는 인증결과 암호화 데이터
※ 절대 임의로 변경 불가하며 결제 창에서 내려 주는 값을 그대로 사용 부탁 드립니다.
ex) "enc_data" : "1eOSNbDDMQCVqCHVNZGNPKZErG2lCPBL24RTDIATPEXWERwBkrN4ghC4M0ue81I8y-LZ1tl6q8CMpw-LvpFdQDKzbHx5tx1OYWBf”

string가변

enc_infoPC / Mobile

결제창 인증결과 암호화 정보
통합 결제 창으로부터 전달 받는 인증결과 암호화 데이터
※ 절대 임의로 변경 불가하며 결제 창에서 내려 주는 값을 그대로 사용 부탁 드립니다.
ex) "enc_info" : "4dgxMICIupJdwMheYKVQI.Vd6cKDpBSSkWfEfW1k431UaMlGzuVl1N.NIsrbdDnQ5i9Mu.JVz.C7JIK1NpdfDkdYd”

string8

tran_cdPC / Mobile

요청코드(수정불가)
ex) "tran_cd" : "00300001"

배치키 발급요청 파라미터

string5

site_cdMobile

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

string가변

kcp_cert_info필수PC / Mobile

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

string가변

enc_dataPC / Mobile

결제창 인증결과 암호화 정보
통합 결제 창으로부터 전달 받는 인증결과 암호화 데이터
※ 절대 임의로 변경 불가하며 결제 창에서 내려 주는 값을 그대로 사용 부탁 드립니다.
ex) "enc_data" : "1eOSNbDDMQCVqCHVNZGNPKZErG2lCPBL24RTDIATPEXWERwBkrN4ghC4M0ue81I8y-LZ1tl6q8CMpw-LvpFdQDKzbHx5tx1OYWBf”

string가변

enc_infoPC / Mobile

결제창 인증결과 암호화 정보
통합 결제 창으로부터 전달 받는 인증결과 암호화 데이터
※ 절대 임의로 변경 불가하며 결제 창에서 내려 주는 값을 그대로 사용 부탁 드립니다.
ex) "enc_info" : "4dgxMICIupJdwMheYKVQI.Vd6cKDpBSSkWfEfW1k431UaMlGzuVl1N.NIsrbdDnQ5i9Mu.JVz.C7JIK1NpdfDkdYd”

string8

tran_cdPC / Mobile

요청코드(수정불가)
ex) "tran_cd" : "00300001"

배치키 발급응답 파라미터

string4

res_cdPC / Mobile

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

string100

res_msgPC / Mobile

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

string16

batch_keyPC / Mobile

배치키이며, 카드인증 후 결과로 내려드리는 카드정보를 암호화한 값입니다.
배치키를 가맹점에서 저장해 두었다가, 결제 주기에 맞춰 해당 값으로 승인요청을 합니다.
Ex) ＂batch_key＂ : ＂240508240394617F"

string4

card_cdPC / Mobile

발급된 배치키의 카드사 코드입니다.
ex) "card_cd" : "CCNH"

string20

card_namePC / Mobile

발급된 배치키의 카드사명입니다.
ex) "card_name" : "NH카드"

number1

card_bin_type_01PC / Mobile

발급된 배치키의 카드 구분 정보입니다.
개인 : 0 / 법인 : 1
ex) "card_bin_type_01" : "0"

number1

card_bin_type_02PC / Mobile

발급된 배치키의 카드 구분 정보입니다.
일반 : 0 / 체크 : 1
ex) "card_bin_type_02" : "0"

결제요청 파라미터

string5

site_cd필수PC / Mobile

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

string가변

kcp_cert_info필수PC / Mobile

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

string4

pay_method필수PC / Mobile

결제수단입니다. 고정값입니다.
ex) "pay_method" : "CARD"

number9

amount필수PC / Mobile

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

number9

card_mny필수PC / Mobile

카드 결제 금액입니다.
ex) "card_mny" : "1000"

string3

currency필수PC / Mobile

화폐단위입니다. ex)"currency " : "410"

string2

quota필수PC / Mobile

할부개월수 입니다. 고정값 일시불입니다.
ex) "quota" : "00"

string40

ordr_idxx필수Mobile

상점에서 관리하는 주문번호입니다. 최대길이는 40자이며, 중복되지 않는 유니크한 값으로 사용하시길 권장합니다.
주문 데이터 관리를 위해 가맹점에서 반드시 저장해야합니다.
ex) "ordr_idxx" : "TEST123456789"

string8

card_tx_type필수PC / Mobile

결제전문 구분값이며, 자동결제 승인요청의 경우 11511000(고정)입니다.
ex) "card_tx_type" : "11511000"

string12

bt_group_id필수PC / Mobile

자동결제 그룹 아이디이며, 배치키 발급 및 승인 시 그룹별로 관리할 수 있습니다.
ex) "bt_group_id" : "A52Q71000348"

string16

bt_batch_key필수PC / Mobile

배치키이며, 카드인증 후 결과로 내려드리는 카드정보를 암호화한 값입니다.
배치키를 가맹점에서 저장해 두었다가, 필요할 때 해당 값으로 승인요청을 합니다.
ex) "bt_batch_key" : "240508240394617F"

string4

media_type필수PC / Mobile

매체 구분입니다.
PC=MC01, 모바일=MC02
ex) "media_type" : "MC01"

string100

good_name필수Mobile

상품명입니다. 최대길이는 100자입니다.
ex) "good_name" : "운동화"

string30

buyr_namePC / Mobile

주문자이름
ex) "buyr_name" : "홍길동"

string50

buyr_mailPC / Mobile

주문자 이메일
입력하신 E-Mail 주소로 결제 결과 메일이 발송됩니다.

string20

buyr_tel2PC / Mobile

주문자 휴대폰번호
하이폰(-)포함 가능
ex) "buyr_tel2" : "010-1234-1234"

결제 응답 파라미터

string4

res_cdPC / Mobile

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

string100

res_msgPC / Mobile

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

string100

res_en_msgPC / Mobile

영문 결과 메시지
ex) "res_en_msg" : "processing completed"

string4

pay_methodPC / Mobile

응답결제수단
신용카드 - PACA

string14

tnoPC / Mobile

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

number9

amountPC / Mobile

결제 금액
결제 건의 총 결제 금액이 리턴 됩니다.
최종 결제 금액의 처리는 승인완료 후 리턴 데이터 중 amount 로 처리하여야 하며 반드시 업체의 DB금액과 비교하여 검증하시기 바랍니다.
ex) "amount" : "1000"

string4

card_cdPC / Mobile

결제 건의 발급 사 코드
ex) "card_cd" : "CCNH"

number9

card_mnyPC / Mobile

결제 건의 총 결제금액 중 신용카드 결제금액
ex) "card_mny" : "8000"

string32

card_namePC / Mobile

결제 건의 발급 사 명
ex) "card_name" : "NH카드"

string16

card_noPC / Mobile

결제 건의 카드번호 (카드번호 16자리 중 3번째구간은 마스킹)
ex) "card_no" : "9441160000001234"

string8

app_noPC / Mobile

결제 건의 승인번호
ex) "app_no" : "46761234"

string14

app_timePC / Mobile

결제 건의 결제(승인) 시간
ex) "app_time" : "20240101235959"

string1

noinfPC / Mobile

결제 건의 무이자 여부
ex) "noinf" : "Y"

string2

quotaPC / Mobile

결제 건의 할부 기간
ex) 일시불일 경우, "quota" : "00"

string4

acqu_cdPC / Mobile

결제 건의 매입사 코드입니다.
ex) "card_name" : "CCAM"

string20

partcanc_ynPC / Mobile

결제 건의 매입사명입니다.
ex) "card_name" : "롯데아멕스카드"

string1

partcanc_ynPC / Mobile

결제 건의 부분취소 가능 유무
ex) "partcanc_yn" : "Y"

number1

card_bin_type_01PC / Mobile

결제 건의 카드 구분 정보
개인 : 0 / 법인 : 1
ex) "card_bin_type_01" : "0"

number1

card_bin_type_02PC / Mobile

결제 건의 카드 구분 정보
일반 : 0 / 체크 : 1
ex) "card_bin_type_02" : "0"

배치키 삭제요청 파라미터

string5

site_cd필수PC / Mobile

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

string가변

kcp_cert_info필수 PC / Mobile

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

string4

pay_method필수PC / Mobile

결제수단으로 배치키 삭제의 경우 BATCH(고정)입니다.
pay_method : BATCH

string8

tx_typePC / Mobile

요청 타입입니다. 10005010 의 고정값을 사용합니다.
ex) " tx_type " : "10005010”

string12

group_idPC / Mobile

자동결제 그룹 아이디이며, 배치키 발급 및 승인 시 그룹별로 관리할 수 있습니다.
ex) "group_id" : "A52Q71000348"

string16

batch_keyPC / Mobile

배치키이며, 카드인증 후 결과로 내려드리는 카드정보를 암호화한 값입니다.
ex) ＂batch_key＂ : ＂240508240394617F"

배치키 삭제응답 파라미터

string4

res_cdPC / Mobile

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

string100

res_msgPC / Mobile

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

목차