PC 렌탈계약
KG이니시스 결제창을 호출하여 안전하게 렌탈계약 및 결제를 제공하는 서비스
Quick Guide


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


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


테스트 실행 및 결과확인
계약 진행과정과
응답결과를 확인해 주세요.

실제 연동진행
가맹점 실서버 환경에 맞게
연동을 진행해주세요.
연동 준비하기
PC 렌탈계약 연동 전, 체크해야할 사항을 안내드립니다.
MID상점아이디
계약 완료 여부, 사용 가능 지불 수단 등은 계약담당자 문의대칭키생성
가맹점관리자 ▶ 상점정보 ▶ 계약정보 ▶ 부가정보 ▶ 웹결제 signkey 생성조회 / INIAPI key 생성조회방화벽정보
항목 | 스테이징환경 | 운영환경 |
---|---|---|
URL | stgstdpay.inicis.com | fcstdpay.inicis.com ksstdpay.inicis.com |
IP | 183.109.71.83 | 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* | 요청지불수단 ["rtpay" 고정] |
N/A
|
mid* | 상점아이디 |
10 byte
|
oid* | 주문번호 반드시 Unique 값으로 생성 (거래추적 시 사용됨) |
40 byte
|
price* | 결제금액 숫자만 허용, 1달러는 100으로 시작 |
12 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
|
charset | 결과 수신 인코딩 [UTF-8, EUC-KR] |
N/A
|
acceptmethod | 복합파라미터 (구분자":"(콜론)) |
N/A
|
acceptmethod 옵션 | ||
rtpay * | 다이렉트 호출 옵션 "rtpay" 고정 |
N/A
|
centerCd(Y) * | IDC센터코드 수신 사용옵션 |
2 byte
|
postNum * | 수령인 우편번호 |
N/A
|
---|---|---|
address * | 수령인 기본주소 |
N/A
|
addressDtl * | 수령인 상세주소 |
N/A
|
rentalPeriod * | 렌탈기간 |
N/A
|
rentalPrice * | 월 렌탈료 |
N/A
|
rentalCompNm * | 사업자명 (셀러) |
N/A
|
rentalCompNo * | 사업자번호 (셀러) 숫자만 세팅 |
N/A
|
rentalCompPhone * | 사업자 휴대폰번호 (셀러) 숫자만 세팅 |
N/A
|
rentalRecipientNm * | 수령인 이름 |
N/A
|
rentalRecipientPhone * | 수령인 휴대폰번호 숫자만 세팅 |
N/A
|
additionalData* | 추가정보 (추가정보 내 JSON 데이터 참조) * 데이터타입 : urlEncoding(JSONString), charset : EUC-KR |
세팅예시
N/A
|
|
---|---|---|---|
추가정보 내 JSON 데이터 | |||
product* | category* | 제품군명 ex) 모니터 |
50 byte
|
manufacturer* | 제조사명 ex) 삼성전자 |
40 byte
|
|
modelName* | 제품모델명 ex) TR17M5 |
50 byte
|
|
serialNo | 제품일련번호 ex) N953ABCDEabcdeL |
20 byte
|
|
billkey | 빌키 |
40 byte
|
|
rentalGoodname | 상품명 goodname의 상품명이 잘리는 경우 사용 권장 (byte수 참고) |
100 byte
|
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센터코드와 비교 검증 필요) - 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 | 인증가격 옵션필드 (제외가능) |
12 byte
|
STEP 4승인결과
※ 유의사항
승인결과 파라미터는 모든 결제 프로세스 종료 후 최종적으로 전달되는 응답파라미터 입니다.
- 응답파라미터는 추후 요건에 의해 추가될 수 있습니다.
- 실패 응답 시, 일부 파라미터 응답이 null 일 수 있습니다.
resultCode | 결과코드 "0000":성공, 이외 실패 (실패코드 6byte) |
6 byte
|
---|---|---|
resultMsg | 결과메세지 |
100 byte
|
payMethod | 요청지불수단["RTPAY" 고정] |
N/A
|
mid | 상점아이디 |
10 byte
|
tid | 거래번호 |
40 byte
|
MOID | 주문번호 결제 요청시 oid 필드에 설정된 값 |
40 byte
|
TotPrice | 결제금액 |
20 byte
|
goodName | 상품명 |
40 byte
|
applDate | 승인일자 [YYYYMMDD] |
8 byte
|
applTime | 승인시간 [hh24miss] |
6 byte
|
EventCode | 이벤트 코드, 카드 할부 및 행사 적용 코드 |
2 byte
|
buyerName | 구매자명 |
30 byte
|
buyerTel | 구매자 휴대폰번호 |
20 byte
|
buyerEmail | 구매자 이메일주소 |
60 byte
|
custEmail | 최종 이메일주소 |
60 byte
|
RTPAY_rentalNo | 렌탈 계약번호 |
40 byte
|
RTPAY_rentalPrice | 렌탈 상품가격 |
20 byte
|
RTPAY_rentalPeriod | 렌탈 개월수 |
5 byte
|
RTPAY_totalPrice | 총렌탈료 |
N/A
|
RTPAY_rentalDate | 렌탈 승인일자 [YYYYMMDD] |
8 byte
|
RTPAY_rentalTime | 렌탈 승인시간 [hh24miss] |
6 byte
|