개발자센터
V1
V2

KICC

KICC 결제창 연동 방법을 안내합니다.

1. KICC PG 설정하기

KICC 설정 페이지의 내용을 참고하여 PG 설정을 진행합니다.

2. 결제 요청하기

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

Javascript SDK
IMP.request_pay( { pg: "kicc.{상점 ID}", pay_method: "card", merchant_uid: "order_no_0001", // 상점에서 생성한 고유 주문번호 name: "주문명:결제테스트", amount: 1004, buyer_email: "test@portone.io", buyer_name: "구매자이름", buyer_tel: "010-1234-5678", // 필수 buyer_addr: "서울특별시 강남구 삼성동", buyer_postcode: "123-456", m_redirect_url: "{모바일에서 결제 완료 후 리디렉션 될 URL}", }, function (rsp) { // callback 로직 //* ...중략... *// } );

주요 파라미터 설명

pg *string

PG사 구분코드

kicc 로 지정하면 됩니다.

pay_method * string

결제수단 구분코드

  • card(신용카드)
  • trans(실시간 계좌이체)
  • vbank(가상계좌)
  • phone(휴대폰소액결제)

merchant_uid * string

주문번호

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

buyer_tel * string

주문자 연락처

amount *number

결제금액

string 이 아닌점에 유의하세요

escrow boolean

에스크로 설정여부

계좌이체, 가상계좌만 지원됩니다.

3. 부가기능

KICC는 현금성 결제수단 (실시간 계좌이체, 가상계좌)에 한하여 에스크로 결제수단을 지원합니다.

에스크로 설정을 위해서는 아래 파라미터를 기본적으로 설정한 후 추가적인 파라미터를

입력해야 합니다.

  • escrow: true

추가 파라미터 안내

에스크로 결제 시 다음 파라미터를 반드시 설정해야 합니다.

  • buyer_name : 구매자 이름
  • buyer_email : 구매자 이메일
  • buyer_tel : 구매자 전화번호
  • kiccProducts : 상품별 부분배송을 위한 상품 관련 정보 (4개의 필수 속성으로 구성된 객체배열). 해당 amount 값은 결제 금액(param.amount) 값과 관계가 없으며 비교검증되지 않습니다.
    • orderNumber : 상품주문번호
    • name : 상품명
    • quantity : 수량
    • amount : 상품 가격
JavaScript SDK
escrow: true, // 에스크로 결제인 경우 필요 kiccProducts: [ { orderNumber: "xxxx", name: "상품A", quantity: 3, amount: 1000, }, { orderNumber: "yyyy", name: "상품B", quantity: 2, amount: 3000, }, ],