모바일 렌탈계약
KG이니시스 결제창을 호출하여 안전하게 렌탈계약 및 결제를 제공하는 서비스
Quick Guide
샘플 다운로드
개발 언어에 맞는 샘플을
다운로드 받아 주세요.
리턴 URL 수정
결과값을 수신받을 수 있는
P_NEXT_URL 을 설정해주세요.
테스트 실행 및 결과확인
계약 진행과정과
응답결과를 확인해 주세요.
실제 연동진행
가맹점 실서버 환경에 맞게
연동을 진행해주세요.
연동 준비하기
모바일 렌탈계약 연동 전, 체크해야할 사항을 안내드립니다.
MID상점아이디
계약 완료 여부, 사용 가능 지불 수단 등은 계약담당자 문의대칭키생성
가맹점관리자 ▶ 상점정보 ▶ 계약정보 ▶ 부가정보 ▶ INIAPI key 생성조회주의 사항(App)
Native App 환경 에서는 Popup으로 인해 Webview 기능을 구현해야함방화벽정보
| 항목 | 스테이징환경 | 운영환경 |
|---|---|---|
| URL | stgmobile.inicis.com | fcmobile.inicis.com ksmobile.inicis.com |
| IP | 118.129.210.154 | 118.129.210.57 183.109.71.50 |
| PORT | 443 | |
| 연결방향 | OUTBOUND | |
STEP 1렌탈계약 요청
렌탈계약 요청정보
- 렌탈계약 요청 URL : https://mobile.inicis.com/smart/payment/
- HTTP Method : POST
- Accept-charset : EUC-KR
- 기본정보
- 렌탈정보
- 추가정보
| P_INI_PAYMENT* | 요청지불수단["RTPAY" 고정] |
10 byte
|
|---|---|---|
| P_MID* | 상점아이디 |
10 byte
|
| P_OID* | 주문번호 반드시 Unique 값으로 생성 (거래추적 시 사용됨) |
40 byte
|
| P_AMT* | 결제금액 숫지만 허용, 콤마(",") 사용불가 |
8 byte
|
| P_GOODS* | 상품명 |
80 byte
|
| P_UNAME* | 구매자명 |
30 byte
|
| P_MOBILE* | 구매자 휴대폰번호 |
15 byte
|
| P_EMAIL* | 구매자 이메일주소 |
30 byte
|
| P_NEXT_URL* | 결과수신 URL |
N/A
|
| P_CHARSET | 결과 수신 인코딩 [utf8, euc-kr] |
N/A
|
| P_NOTI | 가맹점 임의 데이터 |
600 byte
|
| P_RECV_POSTNUM * | 수령인 우편번호 |
6 byte
|
|
|---|---|---|---|
| P_RECV_ADDR * | 수령인 기본주소 |
120 byte
|
|
| P_RECV_ADDR_DETAIL * | 수령인 상세주소 |
120 byte
|
|
| P_RESERVED (복합필드) "&" 로 key=value 나열 |
d_rtpay * | 렌탈페이 다이렉트 호출 플래그 ["Y" 고정] |
N/A
|
| centerCd * | IDC센터코드 수신 사용옵션 ["Y" 고정] |
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 | 상품명 P_GOODS 의 상품명이 잘리는 경우 사용 권장 (byte수 참고) |
100 byte
|
|
STEP 2인증결과
| P_STATUS | 결과코드 "00":성공, 이외 실패 |
4 byte
|
|---|---|---|
| P_RMESG1 | 결과메시지 |
10 byte
|
| P_TID | 인증거래번호 성공시에만 전달 |
40 byte
|
| P_AMT | 거래금액 |
8 byte
|
| idc_name | IDC센터코드 [fc, ks, stg] 승인요청 시 P_REQ_URL 과 비교검증 필요 |
CODE
N/A
|
| P_REQ_URL | 승인요청 URL 해당 URL로 HTTPS API Request 승인요청 - POST 이니시스 제공 승인API 가 맞는지 확인 필요 (IDC센터코드와 비교 검증 필요) |
N/A
|
| P_NOTI | 가맹점 임의 데이터 |
600 byte
|
STEP 3승인요청
승인요청 정보
- 승인요청 URL : STEP2 인증결과 수신 시 응답된 P_REQ_URL
이니시스 제공 승인API 가 맞는지 확인 필요 (IDC센터코드와 비교 검증 필요) - HTTP Method : POST
- 통신방식 : http-Client 통신
| P_MID* | 상점아이디 결제요청 시 세팅한 P_MID 와 동일한 값 세팅 |
10 byte
|
|---|---|---|
| P_TID* | 인증거래번호 |
40 byte
|
STEP 4승인결과
※ 유의사항
승인결과 파라미터는 모든 결제 프로세스 종료 후 최종적으로 전달되는 응답파라미터 입니다.
- 응답파라미터는 추후 요건에 의해 추가될 수 있습니다.
- 실패 응답 시, 일부 파라미터 응답이 null 일 수 있습니다.
| P_STATUS | 결과코드 "00":성공, 이외 실패 (실패코드 4byte) |
4 byte
|
|---|---|---|
| P_RMESG1 | 결과메세지 |
500 byte
|
| P_TID | 거래번호 |
40 byte
|
| P_MID | 상점아이디 |
10 byte
|
| P_OID | 주문번호 |
100 byte
|
| P_AMT | 거래금액 |
8 byte
|
| P_TYPE | 지불수단 |
지불수단
N/A
|
| P_AUTH_DT | 승인일자 [YYYYMMDDhhmmss] |
14 byte
|
| P_UNAME | 구매자명 |
30 byte
|
| P_MNAME | 가맹점명 결제요청 정보에 입력된 값 반환 |
N/A
|
| P_NOTI | 가맹점 임의 데이터 |
600 byte
|
| P_NOTEURL | 가맹점 전달 P_NOTI_URL |
N/A
|
| P_NEXT_URL | 가맹점 전달 P_NEXT_URL |
N/A
|
| 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
|