개발자센터
V1
V2
파트너 정산 릴리즈 노트 기술 블로그

NHN KCP

NHN KCP 결제창 연동 가이드입니다.

1. NHN KCP 채널 설정하기

결제대행사 채널 설정하기 페이지의 내용을 참고하여 채널 설정을 진행합니다.

2. 결제 요청하기

JavaScript SDK IMP.request_pay(param, callback)을 호출하여 NHN KCP 결제창을 호출할 수 있습니다. 결제결과는 PC의 경우 IMP.request_pay(param, callback) 호출 후 callback 으로 수신되고 모바일의 경우 m_redirect_url 로 리디렉션됩니다.

IMP.request_pay(
  {
    pg: "kcp.{사이트코드}", //테스트인경우 kcp.T0000
    pay_method: "card",
    merchant_uid: "order_no_0001", //상점에서 생성한 고유 주문번호
    name: "주문명:결제테스트",
    amount: 1004,
    company: "상호명", //해당 파라미터 설정시 통합결제창에 해당 상호명이 노출됩니다.
    buyer_email: "test@portone.io",
    buyer_name: "구매자이름",
    buyer_tel: "010-1234-5678",
    buyer_addr: "서울특별시 강남구 삼성동",
    buyer_postcode: "123-456",
    language: "ko", // en 설정시 영문으로 출력되면 해당 파라미터 생략시 한국어 default
    m_redirect_url: "{모바일에서 결제 완료 후 리디렉션 될 URL}",
    auth_mode: "key-in", // 키인결제(일회성 결제)이용시 설정
  },
  function (rsp) {
    // callback 로직
    //* ...중략... *//
  },
);

주요 파라미터 설명

pg * string

PG사 구분코드

kcp.{사이트코드}

사이트코드 값은 KCP 계약 후 KCP로 부터 발급받을수 있습니다.

pay_method * string

결제수단 구분코드

  • card (신용카드)
  • samsung (삼성페이)
  • trans (실시간 계좌이체)
  • vbank(가상계좌)
  • phone (휴대폰소액결제)
  • payco (페이코 허브형)
  • lpay(L페이 허브형)
  • cultureland (문화상품권)
  • smartculture (스마트문상)
  • happymoney (해피머니)
  • booknlife (도서문화상품권)
  • point (베네피아 포인트)
  • kakaopay(카카오페이)
  • naverpay(네이버페이)
  • applepay(애플페이)

merchant_uid * string

주문번호

매번 고유하게 채번되어야 합니다.

amount * integer

결제금액

string 이 아닌점에 유의하세요

payco 허브형인 경우 KCP 관리자페이지 신청 및 설정이 필요합니다.

신청안내 링크 : https://sir.kr/main/service/p_payco_hub.php

3. 부가기능

{
  "display": {
    "card_quota": [6] // 할부개월 6개월까지만 활성화
  }
}

파라미터 설명

  • card_quota :
    • []: 일시불만 결제 가능
    • 2,3,4,5,6: 일시불을 포함한 2, 3, 4, 5, 6개월까지 할부개월 선택 가능\

할부결제는 5만원 이상 결제 요청시에만 이용 가능합니다.

할부개월수 3개월까지 활성화 예제

4. 기타 파라미터

상품권 결제수단을 사용하기 위해서는 고객사에서 관리하는 회원ID를 아래와 같은 방법으로 파라미터 설정이 필요합니다.

{
  "bypass": {
    "shop_user_id": "ABCD123" // 고객사 회원ID (20byte)
  }
}

상품권 기관 RM 조치를 위해 필수적으로 실어주셔야 합니다.

컬처랜드 문화 상품권을 호출하는 경우

IMP.request_pay({
  pg: "kcp.{문화상품권 대상 사이트코드}",
  pay_method: "cultureland", //문화상품권
  merchant_uid: "A00021-TEST",
  name: "당근 10kg",
  amount: 1004,
  buyer_email: "iamport@chai.finance",
  buyer_name: "포트원 기술지원팀",
  buyer_tel: "010-1234-5678",
  buyer_addr: "서울특별시 강남구 삼성동",
  buyer_postcode: "123-456",
  bypass: {
    shop_user_id: "abaddd", // 고객사 회원 id기재
  },
});