이지페이(KICC)

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

채널 설정하기

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

가능한 결제 수단

결제창 일반 결제

KICC 해외결제를 통해 위챗페이와 알리페이 플러스를 이용할 수 있습니다. 이용하고자 하는 결제사 별 파라미터는 아래를 참고해주세요.

SDK 결제 요청하기

결제 요청 시에는 requestPayment 함수를 호출해야 합니다. channelKey 파라미터에 결제 채널 연동 후 생성된 채널 키값을 지정하여 KICC 채널 사용을 명시해주세요.

KICC 기준으로 작성한 예시 코드는 아래와 같습니다.

import * as PortOne from "@portone/browser-sdk/v2";
function requestPayment() {
  PortOne.requestPayment({
    storeId: "store-4ff4af41-85e3-4559-8eb8-0d08a2c6ceec", // 고객사 storeId로 변경해주세요.
    channelKey: "channel-key-9987cb87-6458-4888-b94e-68d9a2da896d", // 콘솔 결제 연동 화면에서 채널 연동 시 생성된 채널 키를 입력해주세요.
    paymentId: `payment${crypto.randomUUID()}`,
    orderName: "PortOne Purchase",
    totalAmount: 100, // 1 USD
    currency: "USD",
    payMethod: "EASY_PAY",
    easyPay: {
      easyPayProvider: "WECHAT",
    },
    locale: "KO_KR",
    customer: {
      fullName: "PortOne",
      email: "test@example.com",
    },
  });
}

주요 파라미터 설명

storeId: string

스토어 아이디

포트원 계정에 생성된 상점을 식별하는 고유한 값으로 관리자 콘솔에서 확인할 수 있습니다.

paymentId: string

고객사 주문 고유 번호

고객사가 채번하는 주문 고유 번호입니다.
이미 승인 완료 된 paymentId로 결제를 시도하는 경우 에러가 발생합니다.

orderName: string

주문명

주문명으로 고객사에서 자유롭게 입력합니다.

KICC와 위챗페이에서는 영문만 사용하는 것을 권장합니다.

channelKey: string

채널 키

콘솔에서 채널 연동 시 생성된 채널 키입니다.

totalAmount: number

결제 금액

결제 금액(실제 결제 금액 X 10^ 해당 currency의 scale factor, 예: $1.50 -> 150)

currency: string

결제 통화 코드

ISO 4217 통화 코드

KRW: 한국 원
USD: 미국 달러

locale?: Locale

결제창 언어

ZH_CN: 중국어 (중국 본토) (기본값)
KO_KR: 한국어
EN_US: 영어
ZH_TW: 중국어 (대만)

customer?: object

고객 정보

fullName?: string

구매자 전체 이름

fullName과 firstName / lastName이 모두 입력된 경우 fullName으로 기록됩니다.

firstName?: string

구매자 이름

firstName을 입력하는 경우 lastName도 필수로 입력해야 합니다. fullName이 없고, firstName과 lastName이 존재하는 경우 {firstName} {lastName}으로 저장됩니다.

lastName?: string

구매자 성

lastName을 입력하는 경우 firstName도 필수로 입력해야 합니다.

phoneNumber?: string

구매자 연락처

email?: string

구매자 이메일 주소

import * as PortOne from "@portone/browser-sdk/v2";
function requestPayment() {
  PortOne.requestPayment({
    storeId: "store-4ff4af41-85e3-4559-8eb8-0d08a2c6ceec", // 고객사 storeId로 변경해주세요.
    channelKey: "channel-key-9987cb87-6458-4888-b94e-68d9a2da896d", // 콘솔 결제 연동 화면에서 채널 연동 시 생성된 채널 키를 입력해주세요.
    paymentId: `payment${crypto.randomUUID()}`,
    orderName: "PortOne Purchase",
    orderDescription: "Description for Order",
    totalAmount: 100, // 1 USD
    currency: "USD",
    payMethod: "ALIPAY_PLUS",
    alipayPlus: {
      easyPayProvider: "ALIPAY",
    },
    customer: {
      fullName: "PortOne",
      email: "test@example.com",
    },
  });
}