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

KG이니시스

KG이니시스

PC 빌링키발급

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

Quick Guide

샘플 다운로드

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

리턴 URL 수정

결제요청페이지 도메인과 일치하도록 리턴 URL을
수정해 주세요.

테스트 실행 및 결과확인

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

실제 연동진행

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

연동 준비하기

PC(웹표준)결제 연동 전, 체크해야할 사항을 안내드립니다.

MID상점아이디
계약 완료 여부, 사용 가능 지불 수단 등은 계약담당자 문의
Signkey대칭키
가맹점관리자 ▶ 상점정보 ▶ 계약정보 ▶ 부가정보 ▶ 웹결제 signkey 생성조회
방화벽정보
항목 스테이징환경 운영환경
URL stgstdpay.inicis.com fcstdpay.inicis.com
ksstdpay.inicis.com
IP 118.129.210.47 118.129.210.86
183.109.71.30
PORT 443
연결방향 OUTBOUND

STEP 1인증요청

인증요청정보

  • 인증요청JS : https://stdpay.inicis.com/stdjs/INIStdPay.js
  • HTTP Method : POST
  • Accept-charset : UTF-8
  • 공통
  • 신용카드
  • 휴대폰
version* 전문 버전 ["1.0" 고정]
20 byte
gopaymethod* 요청지불수단
빈값으로 세팅
N/A
mid* 상점아이디
10 byte
oid* 주문번호
반드시 Unique 값으로 생성 (거래추적 시 사용됨)
40 byte
price* 결제금액
숫자만 허용
64 byte
timestamp* 타임스템프 [TimeInMillis(Long형)]
20 byte
use_chkfake* PC결제 보안강화 사용 ["Y" 고정]
1 byte
signature* SHA256 Hash값
대상: oid, price, timestamp
HASH
64 byte
verification* SHA256 Hash값
대상: oid, price, signKey, timestamp
HASH
64 byte
mKey* SHA256 Hash값
대상: mid 와 매칭되는 signKey
HASH
64 byte
offerPeriod 제공기간 [Y2:연 자동결제, M2:월 자동결제, YYYYMMDD-YYYYMMDD:시작일-종료일]
결제 고객에게 노출용도
N/A
charset 결과 수신 인코딩 [UTF-8,EUC-KR]
Default: UTF-8
6 byte
currency* 통화구분 ["WON":한화,"USD":달러]
USD는 카드 결제만 가능
3 byte
goodname* 상품명
40Byte 초과 요청시 37Byte + ...으로 자동 변환
40 byte
buyername* 구매자명
30Byte 초과 요청시 30Byte로 자동 변환
30 byte
buyertel* 구매자 휴대폰번호
숫자와 "-" 만 허용
20 byte
buyeremail* 구매자 이메일주소
"@", "." 외 특수문자 입력불가
60 byte
returnUrl* 결과수신 URL
N/A
closeUrl* 결제창 닫기 URL
N/A

STEP 2인증결과

resultCode 결과코드
"0000":성공, 이외 실패
10 byte
resultMsg 결과메시지
100 byte
mid 상점아이디
10 byte
orderNumber 주문번호
결제요청 시 세팅한 주문번호
40 byte
authToken 승인요청 검증 토큰
N/A
idc_name IDC센터코드 [fc, ks, stg]
승인요청 시 authUrl 과 비교검증 필요
CODE
N/A
authUrl 승인요청 Url
해당 URL로 HTTPS API Request 승인요청 - POST
이니시스 제공 승인API 가 맞는지 확인 필요 (IDC센터코드와 비교 검증 필요)
N/A
netCancelUrl 망취소요청 Url
승인요청 후 승인결과 수신 실패 / DB저장 실패 시
64 byte
charset 인증결과 인코딩 [Default: UTF-8]
6 byte
merchantData 가맹점 임의 데이터
2000 byte

STEP 3빌키발급 요청

빌키요청 정보

  • 빌키요청 URL : STEP2 인증결과 수신 시 응답된 authUrl
    이니시스 제공 승인API 가 맞는지 확인 필요 (IDC센터코드와 비교 검증 필요)
  • Content-type: application/x-www-form-urlencoded
  • HTTP Method : POST
  • 통신방식 : http-Client 통신
mid* 상점아이디
10 byte
authToken* 승인요청 검증 토큰
N/A
timestamp* 타임스템프 [TimeInMillis(Long형)]
20 byte
signature* SHA256 Hash값
대상: authToken, timestamp
HASH
60 byte
verification* SHA256 Hash값
대상: authToken, signKey, timestamp
HASH
60 byte
charset* 인증결과 인코딩 [Default: UTF-8]
6 byte
format* 리턴형식 [XML, JSON, NVP]
리턴샘플
5 byte
price 인증가격
옵션필드 (제외가능)
64 byte
resultLanguage 승인 응답 시, resultMsg 언어 설정 [ "ENG":영문, "CHI":중문, Default:국문 ]
옵션필드 (제외가능)
N/A

STEP 4빌키발급 결과

※ 유의사항

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

  1. 응답파라미터는 추후 요건에 의해 추가될 수 있습니다.
  2. 실패 응답 시, 일부 파라미터 응답이 null 일 수 있습니다.
  • 공통
  • 신용카드
  • 휴대폰
resultCode 결과코드
"0000":성공, 이외 실패 (실패코드 6byte)
6 byte
resultMsg 결과메세지
100 byte
tid 거래번호
40 byte
mid 상점아이디
10 byte
MOID 주문번호
결제 요청시 oid 필드에 설정된 값
40 byte
TotPrice 결제금액
20 byte
goodName 상품명
40 byte
payMethod 지불수단 ["Auth" 고정]
N/A
applDate 승인일자 [YYYYMMDD]
8 byte
applTime 승인시간 [hh24miss]
6 byte
buyerName 구매자명
30 byte
buyerTel 구매자 휴대폰번호
20 byte
buyerEmail 구매자 이메일주소
60 byte
custEmail 최종 이메일주소
60 byte

빌링승인

발급된 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