개발자센터
V1
V2
이 페이지의 다른 버전 보기
파트너 정산 릴리즈 노트 기술 블로그

KG 이니시스

KG이니시스 결제창 연동 가이드입니다.

1. KG이니시스 채널 설정하기

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

2. 결제 요청하기

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

Javascript SDK
IMP.request_pay( { pg: "html5_inicis.{PG상점아이디}", //테스트 시 html5_inicis.INIpayTest 기재 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}", escrow: true, //에스크로 결제인 경우 설정 vbank_due: "YYYYMMDD", bypass: { // PC 경우 acceptmethod: "noeasypay", // 간편결제 버튼을 통합결제창에서 제외(PC) // acceptmethod: "cardpoint", // 카드포인트 사용시 설정(PC) // 모바일 경우 P_RESERVED: "noeasypay=Y", // 간편결제 버튼을 통합결제창에서 제외(모바일) // P_RESERVED: "cp_yn=Y", // 카드포인트 사용시 설정(모바일) // P_RESERVED: "twotrs_bank=Y&iosapp=Y&app_scheme=your_app_scheme://", // iOS에서 계좌이체시 결제가 이뤄지던 앱으로 돌아가기 }, period: { from: "20200101", //YYYYMMDD to: "20201231", //YYYYMMDD }, }, function (rsp) { // callback 로직 //* ...중략... *// }, );

주요 파라미터 설명

pg *string

PG사 구분코드

  • html5_inicis.{PG상점아이디}

PG상점아이디는 KG 이니시스와 계약 후 발급받을 수 있습니다.

pay_method * string

결제수단 구분코드

결제수단 구분코드

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

merchant_uid * string

주문번호

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

amount * integer

결제금액

string 이 아닌점에 유의하세요

buyer_tel * string

주문자연락처

필수 파라미터 입니다.

vbank_due string

가상계좌 입금마감일시를 지정할수 있습니다.(미 지정시 Default 30일)

period array

  • from
  • to

인증 결제창 제공기간을 표현할수 있습니다.

KG이니시스 결제창 예제

3. 부가기능

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

파라미터 설명

  • card_quota : 지정한 숫자에 해당하는 할부개월수만 표기
    • []: 일시불만 결제 가능
    • 2,3,4,5,6: 일시불을 포함한 2, 3, 4, 5, 6 할부개월 선택 가능\

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