실시간 1:1 그룹상담신청
상단으로 이동

KG이니시스

KG이니시스

모바일 빌링키발급

KG이니시스 결제창을 호출하여 정기결제를 위한 billkey 발급 서비스

Quick Guide

샘플 다운로드

개발 언어에 맞는 샘플을
다운로드 받아 주세요.

리턴 URL 수정

결과값을 수신받을 수 있는
리턴 URL 을 설정해주세요.

테스트 실행 및 결과확인

결제 진행과정과
응답결과를 확인해 주세요.

실제 연동진행

가맹점 실서버 환경에 맞게
연동을 진행해주세요.

연동 준비하기

모바일결제 연동 전, 체크해야할 사항을 안내드립니다.

MID상점아이디
계약 완료 여부, 사용 가능 지불 수단 등은 계약담당자 문의
INILite key대칭키
가맹점관리자 ▶ 상점정보 ▶ 계약정보 ▶ 부가정보 ▶ INILite key 생성갱신
방화벽정보
항목 운영환경
URL inilite.inicis.com
IP 203.238.37.166
183.109.71.80
PORT 443
연결방향 OUTBOUND

STEP 1빌키발급 요청

빌키발급 요청정보

  • 신용카드 빌키발급 URL : https://inilite.inicis.com/inibill/inibill_card.jsp
  • 휴대폰     빌키발급 URL : https://inilite.inicis.com/inibill/inibill_hpp.jsp
  • HTTP Method : POST
  • Accept-charset : UTF-8
  • 공통
  • 신용카드
  • 휴대폰
mid* 상점아이디
10 byte
authtype* 인증구분 ["D" 고정]
1 byte
orderid* 주문번호
반드시 Unique 값으로 생성 (거래추적 시 사용됨)
64 byte
price* 결제금액
12 byte
timestamp* 전문생성시간 [YYYYMMDDhhmmss]
14 byte
returnurl* 결과수신 URL
N/A
period* 제공기간 ["Y2":연 자동결제, "M2":월 자동결제, "YYYYMMDDYYYYMMDD":시작일종료일]
24 byte
goodname* 상품명
40 byte
buyername* 구매자명
30 byte
buyertel 구매자 휴대폰번호
20 byte
buyeremail 구매자 이메일주소
60 byte
merchantreserved 상점 예약필드
1000 byte
hashdata* SHA256 Hash값
대상 : mid + orderid + timestamp + INILitekey
HASH
64 byte

STEP 2빌키발급 결과

※ 유의사항

해당 응답파라미터는 모든 프로세스 종료 후 최종적으로 전달되는 결과값 입니다.

  1. 응답파라미터는 추후 요건에 의해 추가될 수 있습니다.
  2. 실패 응답 시, 일부 파라미터 응답이 null 일 수 있습니다.
  • 공통
  • 신용카드
  • 휴대폰
resultcode 결과코드
"00":성공, 이외 실패
4 byte
resultmsg 결과메세지
N/A
pgauthdate 거래일자 [YYYYMMDD]
8 byte
pgauthtime 거래시간 [hhmmss]
6 byte
tid 거래번호
40 byte
mid 상점아이디
10 byte
orderid 주문번호 (빌키발급 요청 시 세팅한 값)
N/A
billkey 발급된 빌링키
40 byte
authkey 빌링인증 트렌젝션 ID
40 byte
merchantreserved 상점 예약필드
1000 byte

(추가) 보안강화

보안강화 방법 (선택사항)

모바일 빌링키발급 시 보안강화 옵션에 대해 안내드립니다.

  • 요청전문 내 hashdata 생성 시 hash 대상파라미터 내 price 값이 추가됩니다.
  • billkey 응답 시 암호화된 값으로 응답됩니다.
  • 보안강화 요청
  • 보안강화 응답
flg_crypto 보안추가 사용여부 ["Y": 사용]
1 byte
hashdata 전문위변조 HASH 항목추가
hash(price+mid+orderid+timestamp+INILitekey)
N/A

빌링승인

발급된 billkey 로 실과금요청을 위한 API 서비스 (PC/모바일 공통)

STEP1빌링승인 요청

빌링승인 요청정보

  • 요청전문 형식 : JSON  NVP
  • 빌링요청URL : https://iniapi.inicis.com/v2/pg/billing
  • Header 정보
    POST /v2/pg/billing HTTP/1.1
    Host: iniapi.inicis.com
    Content-type: application/json
  • 유의사항
  1. 빌키발급결과 페이지 내 빌링승인 API 를 연동하실 경우, 결과페이지 새로고침 또는 재호출 시
    빌링승인 API 가 중복으로 호출되어 중복결제되는 이슈가 발생될 수 있습니다.
    반드시 빌링키발급과 빌링승인 API 를 분리하여 연동을 부탁드립니다.
mid* String 상점아이디
10 byte
type* String 요청서비스 ["billing" 고정]
7 byte
paymethod* String 지불수단 코드 [card:신용카드, HPP:휴대폰]
10 byte
timestamp* String 전문생성시간 [YYYYMMDDhhmmss]
14 byte
clientIp* String 가맹점 요청 서버IP (추후 거래 확인 등에 사용됨)
15 byte
hashData* String SHA512 HASH 한 값
대상 : INIAPIKey + mid + type + timestamp + data
HASH
128 byte
data* Data 요청데이터
N/A
Data 상세
url* String 가맹점 URL
50 byte
moid* String 주문번호
40 byte
goodName* String 상품명
80 byte
buyerName* String 구매자명
80 byte
buyerEmail* String 구매자 이메일주소
"@", "." 외 특수문자 입력불가
60 byte
buyerTel String 구매자 휴대폰번호
40 byte
price* String 결제금액
10 byte
billKey* String 승인요청할 빌링키 값
40 byte
authentification* String 본인인증 여부 ["00" 고정]
본인인증 안함 가맹점으로 별도계약된 경우 "99" 로 세팅
2 byte
regNo String 생년월일 [YYMMDD] 또는 사업자번호
ENC
10 byte
cardPw String 카드비밀번호 앞 2자리
ENC
2 byte
tax String 부가세
"부가세 업체정함" 계약가맹점만 설정필요
10 byte
taxFree String 비과세
"부가세 업체정함" 계약가맹점만 설정필요
10 byte
currency String 통화코드 [WON,USD]
3 byte
cardQuota String 할부기간 ["00":일시불, 그 외 : 02, 03 ...]
2 byte
quotaInterest String 무이자구분 ["1":무이자]
"상점부담무이자" 계약 가맹점만 사용
1 byte