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

이지페이(KICC)

이지페이(KICC) 결제창 연동 방법을 안내합니다.

1. 이지페이(KICC) 채널 설정하기

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

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, }, ],