API Reference > 결제승인
결제승인
결제승인
인증 결과 데이터를 API 통신을 통해 결제 승인 요청 및 응답하는 단계입니다.
요청 데이터는 NHN KCP의 API URL로 json string 형태로 전송 바랍니다.
테스트 : https://stg-spl.kcp.co.kr/gw/enc/v1/payment
운영 : https://spl.kcp.co.kr/gw/enc/v1/payment
Header
Protocol: HTTPS
HTTP Method: POST
Content-Type: application/json; charset=UTF-8
Request Body 파라미터
{
"tran_cd":"00100000",
"kcp_cert_info" : "-----BEGIN CERTIFICATE-----MIIDgTCCAmmgAwIBAgIHkiG..==-----END CERTIFICATE-----",
"site_cd":"T0000",
"enc_data":"SnvXdGftIEjAequorkpNhJXc4hfghdfs5dfsgu3GRuotLHW9vyDDOhdeorM4DPXMJgJlIEoRo6divo=",
"enc_info":"3dsgjljlsSEGHsdccndsgnfdSDDhhbdrhffRbdfRYHFgfgnb=_",
"ordr_mony":"1000",
"pay_type":"PACA",
"ordr_no":"TEST123456789"
}
site_cd필수PC / Mobile
길이 5자리로 영문대문자 또는 영문대문자+숫자로 구성됩니다.
모든 서비스에 사용합니다.
ex) "site_cd" : "T0000"
kcp_cert_info필수PC / Mobile
NHN KCP 에서 발급하는 서비스 인증서로, 상점관리자의 인증센터에서 다운받은 pem 파일내용을 직렬화 하여 사용합니다.
모든 서비스에 사용합니다.
ex) "kcp_cert_info" : "-----BEGIN CERTIFICATE-----MIIDgTCCAmmgAwIBAgIHkiG9w0…………Cay7pJNWXCnw4jIiBsTBa3q95RVRyMEcDgPwugMXPXGBwNoMOOpuQ==-----END CERTIFICATE-----"
enc_data필수PC / Mobile
결제창 인증결과 암호화 정보
통합 결제 창으로부터 전달 받는 인증결과 암호화 데이터
※ 절대 임의로 변경 불가하며 결제 창에서 내려 주는 값을 그대로 사용 부탁 드립니다.
ex) "enc_data" : "1eOSNbDDMQCVqCHVNZGNPKZErG2lCPBL24RTDIATPEXWERwBkrN4ghC4M0ue81I8y-LZ1tl6q8CMpw-LvpFdQDKzbHx5tx1OYWBf"
enc_info필수PC / Mobile
결제창 인증결과 암호화 정보
통합 결제 창으로부터 전달 받는 인증결과 암호화 데이터
※ 절대 임의로 변경 불가하며 결제 창에서 내려 주는 값을 그대로 사용 부탁 드립니다.
ex) "enc_info" : "4dgxMICIupJdwMheYKVQI.Vd6cKDpBSSkWfEfW1k431UaMlGzuVl1N.NIsrbdDnQ5i9Mu.JVz.C7JIK1NpdfDkdYd"
tran_cd필수PC / Mobile
요청코드(수정불가)
ex) "tran_cd" : "00100000"
ordr_mony필수PC / Mobile
실제 결제 요청 금액(결제금액 유효성 검증)
ex) "ordr_mony" : "1000"
ordr_no필수PC / Mobile
실제 결제 주문번호
ex) "ordr_no" : "TEST123456789"
pay_type필수PC / Mobile
실제 결제수단(결제수단 유효성 검증)
가맹점 서버에 저장된 결제수단에 값을 입력해주세요.
신용카드 : PACA
계좌이체 : PABK
휴 대 폰 : PAMC
포 인 트 : PAPT
상 품 권 : PATK
ex) "pay_type" : "PACA"
Response 파라미터
결제수단(신용카드, 계좌이체, 휴대폰, 포인트, 상품권) 별 응답 파라미터가 상이하므로,
승인 응답 저장 시에는 tno , pay_method, amount 및 결제수단 별 응답 파라미터를 저장하여 관리해 주세요.
//신용카드 응답 데이터 예시
{
"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"
}
결제승인 파라미터
공통 승인 응답
res_cdPC / Mobile
결과코드
정상 승인이 이루어졌을 경우 ‘0000’ 값 리턴
ex) "res_cd" : "0000"
res_msgPC / Mobile
결과메세지
ex) "res_msg" : "정상처리"
pay_methodPC / Mobile
응답결제수단
신용카드 - PACA
계좌이체 - PABK
가상계좌 - PAVC
포인트 - PAPT
휴대폰 - PAMC
상품권 - PATK
카카오머니 - PAKM
네이버페이 포인트 - PANP
ex) 신용카드일 경우, "pay_method" : "PACA"
tnoPC / Mobile
NHN KCP 거래 고유번호
※ 거래고유번호 전체로 사용 하시기 바랍니다.
(임의의 숫자나 파싱하여 사용 불가)
ex) "tno" : "24123456789012"
amountPC / Mobile
결제 금액
결제 건의 총 결제 금액이 리턴 됩니다.
최종 결제 금액의 처리는 승인완료 후 리턴 데이터 중 amount 로 처리하여야 하며 반드시 업체의 DB금액과 비교하여 검증하시기 바랍니다.
ex) "amount" : "1000"
신용카드 승인 응답
card_cdPC / Mobile
결제 건의 발급 사 코드
ex) "card_cd" : "CCNH"
card_namePC / Mobile
결제 건의 발급 사 명
ex) "card_name" : "NH카드"
card_noPC / Mobile
결제 건의 카드번호 (카드번호 16자리 중 3번째구간은 마스킹)
ex) "card_no" : "9441160000001234"
app_noPC / Mobile
결제 건의 승인번호
ex) "app_no" : "46761234"
app_timePC / Mobile
결제 건의 결제(승인) 시간
ex) "app_time" : "20260101235959"
noinfPC / Mobile
결제 건의 무이자 여부
ex) "noinf" : "Y"
noinf_typePC / Mobile
noinf = Y 일 때 (무이자 결제인 경우)
카드사 이벤트 무이자인 경우 : CARD
상점 부담 무이자인 경우 : SHOP
ex) 카드사 이벤트일 경우, "noinf_type" : "CARD"
quotaPC / Mobile
결제 건의 할부 기간
ex) 일시불일 경우, "quota" : "00"
card_mnyPC / Mobile
결제 건의 총 결제금액 중 신용카드 결제금액
만약 총 결제금액(amount) 10000 원 중 쿠폰할인 2000 원 받았다면 card_mny=8000 이 됩니다.
*페이코 포인트, 쿠폰 100% 결제 시 card_mny=0 으로 리턴될 수 있으니 반드시
총 결제 금액 처리는 amount 금액으로 체크하시기 바랍니다.
ex) "card_mny" : "8000"
coupon_mnyPC / Mobile
결제 건의 쿠폰 할인 금액 또는 페이코 포인트 사용 금액이 리턴됩니다.
만약 총 결제금액(amount) 10000 원 중 쿠폰 할인을 2000 원 받았다면 coupon_mny=2000 이 됩니다.
ex) "coupon_mny" : "2000"
payco_point_mnyPC / Mobile
페이코 포인트 사용 금액
ex) "payco_point_mny" : "2000"
partcanc_ynPC / Mobile
결제 건의 부분취소 가능 유무
ex) "partcanc_yn" : "Y"
card_bin_type_01PC / Mobile
결제 건의 카드 구분 정보
개인 : 0 / 법인 : 1
ex) "card_bin_type_01" : "0"
card_bin_type_02PC / Mobile
결제 건의 카드 구분 정보
일반 : 0 / 체크 : 1
ex) "card_bin_type_02" : "0"
isp_issuer_cdPC / Mobile
ISP 계열 카드 발급 사 코드
BC96 : 케이뱅크카드
KM90 : 카카오뱅크카드
ex) "isp_issuer_cd" : "BC96"
isp_issuer_nmPC / Mobile
ISP 계열 카드 발급 사 명
카카오뱅크의 경우 카카오뱅크 케이뱅크의 경우 K뱅크카드로 리턴됩니다.
ex) "isp_issuer_nm" : "K뱅크카드"
계좌이체 승인 응답
bank_namePC / Mobile
결제 건의 은행 명
※ 테스트서버에서 계좌이체 테스트 시 금융결제원과 협의된 은행명으로 리턴됩니다.
ex) "bank_name" : "기업은행"
bank_codePC / Mobile
결제 건의 은행코드
※ 테스트서버에서 계좌이체 테스트 시 금융결제원과 협의된 은행 코드로 리턴됩니다.
ex) "bank_code" : "BK03"
bk_mnyPC / Mobile
결제 건의 계좌이체 결제 금액
ex) "bk_mny" : "1000"
cash_authnoPC / Mobile
현금영수증 승인번호
NHN KCP 결제 창에서 현금영수증 등록 요청한 결제 건의 현금영수증 승인번호
ex) "cash_authno" : "591234567"
cash_noPC / Mobile
NHN KCP 결제 창에서 현금영수증 등록 요청한 결제 건의 현금영수증 거래번호
ex) "cash_no" : "20370466727800"
app_timePC / Mobile
계좌이체 결제시각입니다.
ex) "app_time" : "20260101235959”
휴대폰 승인 응답
commidPC / Mobile
결제 건의 통신사 코드
ex) "commid" : "SKT"
mobile_noPC / Mobile
결제 건의 휴대폰 번호
가운데 4자리 마스킹 되어 응답합니다.
ex) "mobile_no" : "01000001234"
hp_app_timePC / Mobile
승인시간
ex) "hp_app_time" : "20260101235959"
포인트 승인 응답
pnt_amountPC / Mobile
결제 건의 포인트 결제 금액
ex) "pnt_amount" : "1000"
pnt_issuePC / Mobile
포인트 기관 코드
OK 캐쉬벡 - SCSK
베네피아 - SCWB
ex) "pnt_issue" : "SCWB"
pnt_app_noPC / Mobile
결제 건의 포인트 승인번호
ex) "pnt_app_no" : "1234567890"
pnt_app_timePC / Mobile
결제 건의 포인트 승인시각
ex) "pnt_app_time" : "20240507235959"
pnt_receipt_gubnPC / Mobile
결제 건의 현금영수증 등록유무
ex) "pnt_receipt_gubn" : "Y"
cash_authnoPC / Mobile
결제 건의 현금영수증 승인번호
ex) "cash_authno" : "591234567"
add_pntPC / Mobile
결제 건의 적립/사용 포인트
ex) "add_pnt" : "1000"
use_pntPC / Mobile
결제 건의 가용 포인트
ex) "use_pnt" : "5000"
rsv_pntPC / Mobile
결제 건의 총 포인트
ex) "rsv_pnt" : "5000"
상품권 승인 응답
tk_mnyPC / Mobile
결제 건의 상품권 결제 금액
ex) "tk_mny" : "1000"
tk_van_codePC / Mobile
상품권 기관 코드입니다.
도서상품권 - SCBL
해피머니 - SCHM
컬쳐랜드 상품권 - SCCL
스마트문상 - SCGM
틴캐시 - SCTC
에그머니 - SCEM
ex) "tk_van_code" : "SCBL"
tk_app_noPC / Mobile
결제 건의 승인번호
ex) "tk_app_no" : "20260101007918"
tk_app_timePC / Mobile
결제 건의 승인시간
ex) "tk_app_time" : "20260101235959"