이지페이(KICC)

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

Javascript SDK
IMP.request_pay(
  {
    channelKey: "{콘솔 내 연동 정보의 채널키}",
    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 로직
    //* ...중략... *//
  },
);

주요 파라미터 설명

channelKey * string

채널키

결제를 진행할 채널을 지정합니다.

포트원 콘솔 내 [결제 연동] - [연동 정보] - [채널 관리] 에서 확인 가능합니다.

(최신 JavaScript SDK 버전부터 사용 가능합니다.)

pg (deprecated) string

PG사 구분코드

kicc 로 지정하면 됩니다.

pay_method * string

결제수단 구분코드

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

merchant_uid * string

주문번호

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

buyer_tel * string

주문자 연락처

amount *number

결제금액

string 이 아닌점에 유의하세요

escrow boolean

에스크로 설정여부

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

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

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

입력해야 합니다.

• escrow: true

추가 파라미터 안내

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

• buyer_name : 구매자 이름

• buyer_email : 구매자 이메일

• buyer_tel : 구매자 전화번호

• kiccProducts : 상품별 부분배송을 위한 상품 관련 정보 (4개의 필수 속성으로 구성된 객체배열). 해당 amount 값은 결제 금액(param.amount) 값과 관계가 없으며 비교검증되지 않습니다.

  • orderNumber : 상품주문번호
  • name : 상품명
  • quantity : 수량
  • amount : 상품 가격

{
  "escrow": true, // 에스크로 결제인 경우 필요
  "kiccProducts": [
    {
      "orderNumber": "xxxx",
      "name": "상품A",
      "quantity": 3,
      "amount": 1000
    },
    {
      "orderNumber": "yyyy",
      "name": "상품B",
      "quantity": 2,
      "amount": 3000
    }
  ]
}