API Reference > 거래등록

거래등록

테스트 : https://testsmpay.kcp.co.kr/trade/register.do 
운영 : https://smpay.kcp.co.kr/trade/register.do

Header

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

Request Body 파라미터


 //거래등록 필수 파라미터
{
 "site_cd":"T0000",
 "ordr_idxx":"TEST123456789",
 "good_mny":"1000",
 "good_name":"운동화",
 "pay_method":"CARD",
 "Ret_URL":"https://쇼핑몰주문처리서버/../return"
 "escw_used":"N"         // 에스크로 파라미터
}

string5

site_cd필수Mobile

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

string50

ordr_idxx필수Mobile

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

number12

good_mny필수Mobile

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

string4

pay_method필수Mobile

결제수단 코드 값 입니다.

자동결제 : AUTH
신용카드 : CARD
계좌이체 : BANK
휴대폰 : MOBX
포인트 : TPNT
상품권 : GIFT
ex) "pay_method" : "CARD"

string100

good_name필수Mobile

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

string256

Ret_URL필수Mobile

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

string40

user_agentMobile

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

string1

escw_used필수Mobile

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

Response 파라미터

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

거래등록 해쉬 정보입니다.
거래등록 요청 값들에 대한 위변조를 검증하기 위한 정보이며 거래등록 요청 값들을 ntMethod 형태로 하나의 문자로 만든후 sha256 로 해쉬처리한 값입니다.
ex) "hashData" : "cn447332cab4...93b3b27f6736653bb"

string가변

traceNoMobile

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

string4

paymentMethodMobile

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

본인확인 서비스 거래등록

테스트 : https://testcert.kcp.co.kr/api/reg/certDataReg.do 
운영 : https://cert.kcp.co.kr/api/reg/certDataReg.do

Request Body 파라미터

거래등록 요청 시 하단 요청 전문(JSON)은 암호화 처리 후 생성된 enc_data 값을 문자열로 직접 전송합니다.
✅ enc_data 값 생성 방법은 본인확인 서비스 Guide 를 확인해 주세요.

실제 전문 예시

enc_data = “nLyG/5nbyqYuUw9f………………………………….6d1SkGI/DzIKksQ6xiTs”

string5

site_cd필수PC/Mobile

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

string50

ordr_idxx필수PC/Mobile

string256

Ret_URL필수PC/Mobile

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

string12

web_siteid필수PC/Mobile

사이트 식별코드
본인확인서비스 요청 시 DI정보 (중복가입확인정보)를 받기 위해 각 사이트마다 고유하게 부여되는 아이디
*web_siteid 값이 없으면 NHN KCP 에서 지정한 값으로 설정됩니다. ex) "web_siteid" : "J12345678901"

string500

param_opt_1 PC/Mobile

NHN KCP 기본 파라미터 외 업체 추가 파라미터입니다. (opt_1, opt_2, opt_3 세개까지 가능합니다.)
ex) "param_opt_1" : "test"

Response 파라미터

{
 "res_cd":"0000",
 "res_msg":"정상처리",
 "call_url":"https://tescert.kcp.co.kr.......",
 "reg_cert_key":"1234567890123456",
}

string4

res_cdPC/Mobile

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

string100

res_msgPC/Mobile

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

string256

call_urlPC/Mobile

인증 창 호출 주소
전달 받은 값 그대로 요청
ex) "call_url" : "https://testcert.kcp.co.kr..."

string20

reg_cert_keyPC/Mobile

거래 등록 키 본인확인 창 호출 및 거래등록 결과 조회에서 사용되는 값으로 반드시 DB 처리하시기 바랍니다.
ex) "reg_cert_key" : "1234567890123456"

거래등록

거래등록

Header

Request Body 파라미터

Response 파라미터

본인확인 서비스 거래등록

Request Body 파라미터

Response 파라미터

문서 목차