렌탈료조회
KG이니시스의 이니렌탈 서비스 이용 시, 공급가 기준의 월렌탈료를 조회하는 API 서비스
※ 월렌탈료는 이니렌탈 계약 시 확정된 렌탈요율을 근거로 산정됩니다.
Quick Guide
샘플 다운로드
개발 언어에 맞는 샘플을
다운로드 받아 주세요.
테스트 실행 및 결과확인
진행과정과
응답결과를 확인해 주세요.
실제 연동진행
가맹점 실서버 환경에 맞게
연동을 진행해주세요.
연동 준비하기
렌탈료조회 API 연동 전, 체크해야할 사항을 안내드립니다.
MID상점아이디
계약 완료 여부, 사용 가능 지불 수단 등은 계약담당자 문의대칭키생성
가맹점관리자 ▶ 상점정보 ▶ 계약정보 ▶ 부가정보 ▶ 웹결제 signkey 생성조회 / INIAPI key 생성조회방화벽정보
| 항목 | 운영환경 |
|---|---|
| URL | inirt.inicis.com |
| IP | 118.129.210.220 183.109.71.220 |
| PORT | 443 |
| 연결방향 | OUTBOUND |
STEP1렌탈료(단건) 조회요청
렌탈료(단건) 조회 요청정보
- 렌탈료(단건) 조회 요청URL : https://inirt.inicis.com/contract/v1/inquiryRentalFee
- POST /contract/v1/inquiryRentalFee HTTP/1.1
- Host: inirt.inicis.com
- Content-Type: application/json
| mid* | 상점아이디 |
10 byte
|
|---|---|---|
| clientType* | 요청유형 ["MR" 고정] |
3 byte
|
| sid* | 거래 고유아이디 (거래확인(추적)을 위한 고유 값) 형식 : " RENTAL" + MID(상점아이디) + YYYYMMDDhhmmss + 랜덤 세자리 Ex. RENTAL INIpayTest 20200709103700 156 |
40 byte
|
| amount* | 상품총액 숫자만 설정, 콤마(",") 사용불가 |
10 byte
|
STEP2렌탈료(단건) 조회응답
※ 유의사항
해당 응답파라미터는 모든 프로세스 종료 후 최종적으로 전달되는 결과값 입니다.
- 응답파라미터는 추후 요건에 의해 추가될 수 있습니다.
- 실패 응답 시, 일부 파라미터 응답이 null 일 수 있습니다.
| resultCode | 결과코드 "00":성공, 이외 실패 |
4 byte
|
|
|---|---|---|---|
| resultMsg | 결과메세지 |
100 byte
|
|
| rentalInfo
(렌탈정보) * 형식 : array[Object] |
rentalPeriod | 렌탈기간 |
3 byte
|
| monthlyRentalAmount | 월 렌탈금액 |
10 byte
|
|
| creditRating | 서비스 가능 최저 신용등급 |
10 byte
|
|
| prePayment | 선납금 선납금 미적용 가맹점은 "0" |
10 byte
|
|
STEP1렌탈료(다수건) 조회요청
렌탈료(다수건) 조회 요청정보
- 렌탈료(다수건) 조회 요청URL : https://inirt.inicis.com/contract/v1/inquiryRentalFeeMulti
- POST /contract/v1/inquiryRentalFeeMulti HTTP/1.1
- Host: inirt.inicis.com
- Content-Type: application/json
| mid* | 상점아이디 |
10 byte
|
|
|---|---|---|---|
| clientType* | 요청유형 ["MR" 고정] |
3 byte
|
|
| rentalFeeList
(렌탈료 리스트) * 형식 : array[Object] |
sid* | 거래 고유아이디 (거래확인(추적)을 위한 고유 값) 형식 : " RENTAL" + MID(상점아이디) + YYYYMMDDhhmmss + 랜덤 세자리 Ex. RENTAL INIpayTest 20200709103700 156 |
40 byte
|
| amount* | 상품총액 숫자만 설정, 콤마(",") 사용불가 |
10 byte
|
|
STEP2렌탈료(다수건) 조회응답
※ 유의사항
해당 응답파라미터는 모든 프로세스 종료 후 최종적으로 전달되는 결과값 입니다.
- 응답파라미터는 추후 요건에 의해 추가될 수 있습니다.
- 실패 응답 시, 일부 파라미터 응답이 null 일 수 있습니다.
| resultCode | 결과코드 "00":성공, 이외 실패 |
4 byte
|
||
|---|---|---|---|---|
| resultMsg | 결과메세지 |
100 byte
|
||
| rentalFeeList
(렌탈료 리스트) * 형식 : array[Object] |
sid | 거래 고유아이디 |
40 byte
|
|
| rentalInfo
(렌탈정보) * 형식 : array[Object] |
rentalPeriod | 렌탈기간 |
3 byte
|
|
| monthlyRentalAmount | 월 렌탈금액 |
10 byte
|
||
| creditRating | 서비스 가능 최저 신용등급 |
10 byte
|
||
| prePayment | 선납금 선납금 미적용 가맹점은 "0" |
10 byte
|
||