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

KG이니시스

KG이니시스

PC 일반결제

KG이니시스 결제창을 호출하여 다양한 지불수단으로 안전한 결제를 제공하는 서비스

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
  • 필수파라미터
  • 선택파라미터
  • 추가옵션 (acceptmethod)
version* 전문 버전 ["1.0" 고정]
20 byte
gopaymethod* 요청지불수단
빈값으로 세팅 시, 전체 결제수단 표시
지불수단
N/A
mid* 상점아이디
10 byte
oid* 주문번호
반드시 Unique 값으로 생성 (거래추적 시 사용됨)
40 byte
price* 결제금액
숫자만 허용, 1달러는 100으로 시작
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
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
acceptmethod* "centerCd(Y)" IDC센터코드 수신 사용옵션 세팅 필수
ex) acceptmethod = centerCd(Y)
여러옵션 추가 세팅 시 ":"(콜론) 구분자 사용
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 지불수단
지불수단
N/A
applDate 승인일자 [YYYYMMDD]
8 byte
applTime 승인시간 [hh24miss]
6 byte
EventCode 이벤트 코드, 카드 할부 및 행사 적용 코드
2 byte
buyerName 구매자명
30 byte
buyerTel 구매자 휴대폰번호
20 byte
buyerEmail 구매자 이메일주소
60 byte
custEmail 최종 이메일주소
60 byte

(예외) 망취소처리 요청

망취소요청 정보

가맹점에서 승인결과 전문 처리 중 예외발생 시 망취소 요청할 수 있습니다.

※ 망취소 요청가능시간 : 인증결과 응답 후 10분 이내

※ 망취소를 일반 결제취소 용도로 사용하지 마십시오.

  • 망취소요청 URL : STEP2 인증결과 수신 시 응답된 netCancelUrl
  • 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