그룹상담신청
상단으로 이동

KG이니시스

KG이니시스

정보등록

KG이니시스를 통한 지급대행을 위해 대행정보 등록 및 수정하는 API 서비스


※ 해당 서비스는 신규 이용 신청이 종료되었습니다. 기존 이용중인 가맹점만 연동 가능합니다. 신규 이용 가맹점은 신버전 (AML) 가이드를 확인하시기 바랍니다.

Quick Guide

서비스 신청

1588-4954(고객센터)
또는 영업담당자를 통해
대사서비스를 신청해주세요.

가맹점 IP 등록

영업담당자를 통해 가맹점의
공인서버 IP 를 등록해주세요.

서브몰 계좌정보 확인

지급할 서브몰의 계좌정보를
확인 후 정확히 입력해주세요.

파라미터 세팅 후 URL 호출

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

STEP1정보등록 요청

정보등록 요청정보

정보등록 요청URL : https://iniweb.inicis.com/DefaultWebApp/mall/cr/open/OpMallUrlConnection.jsp

  • HTTP Method : GET / POST
  • Accept-charset : EUC-KR
id_merchant* MID(상점아이디)
10 byte
id_mall* 판매자 ID
60 byte
cl_id* 판매자 유형 ["1": main mall, "2": sub mall]
2 byte
no_comp 사업자번호
숫자만 허용
10 byte
nm_comp* 상호
50 byte
nm_boss* 사업주명
30 byte
nm_regist* 계좌성명
50 byte
cd_bank* 은행코드
우측 "통합코드" 참고
2 byte
no_acct* 계좌번호
숫자만 허용
20 byte
no_tel* 전화번호
숫자만 허용
20 byte
cl_gubun* 요청구분 ["1": 등록, "2": 갱신]
1 byte

STEP2정보등록 응답

resultcode 결과코드
"00" 정상처리
에러코드
2 byte
resultmsg 결과메세지
에러코드
N/A

지급요청

KG이니시스에 등록된 서브몰에 지급대행 요청 및 삭제처리하는 API 서비스

Quick Guide

서비스 신청

1588-4954(고객센터)
또는 영업담당자를 통해
대사서비스를 신청해주세요.

가맹점 IP 등록

영업담당자를 통해 가맹점의
공인서버 IP 를 등록해주세요.

서브몰 계좌정보 확인

서브몰 등록 시, 입력한 데이터와
일치하도록 값을 세팅해주세요.

파라미터 세팅 후 URL 호출

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

STEP1지급대행 요청

지급대행 요청정보

지급대행 요청URL : https://iniweb.inicis.com/DefaultWebApp/mall/cr/open/OpMallReqUrlConnection.jsp

  • HTTP Method : GET / POST
  • Accept-charset : EUC-KR
id_merchant* MID(상점아이디)
10 byte
id_mall* 판매자 ID
60 byte
dt_pay* 지급일자 [YYYYMMDD]
숫자만 허용
8 byte
no_comp 사업자번호
숫자만 허용
10 byte
nm_regist* 계좌성명
50 byte
cd_bank* 은행코드
우측 "통합코드" 참고
2 byte
no_acct* 계좌번호
숫자만 허용
20 byte
amt_supply* 지급액
숫자만 허용
22 byte
cl_service 차수구분 ["2": 당일지급, Null은 0으로 간주]
당일지급은 별도계약 후 사용가능
1 byte
cl_status 요청상태 ["I": 등록, "D": 삭제, , Null은 I 로 간주]
1 byte

STEP2지급대행 응답

resultcode 결과코드
"00" 정상처리
에러코드
2 byte
resultmsg 결과메세지
에러코드
N/A

환불요청

KG이니시스를 통해 지급대행 환불 요청 등록 및 삭제처리하는 API 서비스

Quick Guide

서비스 신청

1588-4954(고객센터)
또는 영업담당자를 통해
대사서비스를 신청해주세요.

가맹점 IP 등록

영업담당자를 통해 가맹점의
공인서버 IP 를 등록해주세요.

환불 계좌정보 확인

환불받을 계좌정보를
확인 후 정확히 입력해주세요.

파라미터 세팅 후 URL 호출

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

STEP1환불처리 요청

환불처리 요청정보

환불처리 요청URL : https://iniweb.inicis.com/DefaultWebApp/mall/cr/open/OpMallRefundUrlConnection.jsp

  • HTTP Method : GET / POST
  • Accept-charset : EUC-KR
id_merchant* MID(상점아이디)
10 byte
id_buyer* 판매자 ID
60 byte
dt_pay* 지급일자 [YYYYMMDD]
숫자만 허용
8 byte
nm_regist* 계좌성명
50 byte
cd_bank* 은행코드
우측 "통합코드" 참고
2 byte
no_acct* 계좌번호
숫자만 허용
20 byte
amt_supply 지급액
숫자만 허용
22 byte
nm_return 실패사유
100 byte
cl_service 차수구분 ["2": 당일지급, Null은 0으로 간주]
당일지급은 별도계약 후 사용가능
1 byte
cl_status 요청상태 ["I": 등록, "D": 삭제, , Null은 I 로 간주]
1 byte

STEP2환불처리 응답

resultcode 결과코드
"00" 정상처리
에러코드
2 byte
resultmsg 결과메세지
에러코드
N/A

송금결과 & 잔액대사

KG이니시스를 통한 지급대행 송금결과 및 잔액 확인 API 서비스

Quick Guide

서비스 신청

1588-4954(고객센터)
또는 영업담당자를 통해
대사서비스를 신청해주세요.

가맹점 IP 등록

영업담당자를 통해 가맹점의
공인서버 IP 를 등록해주세요.

서브몰 정보 확인

서브몰의 정보를
확인 후 정확히 입력해주세요.

파라미터 세팅 후 URL 호출

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

STEP1송금결과 요청

송금결과 요청정보

송금결과 요청URL : https://iniweb.inicis.com/service/open/remit_result.jsp

  • HTTP Method : GET / POST
  • Accept-charset : EUC-KR
strReqNo* 결과유형 ["1": 지급결과, "2": 환불결과]
1 byte
strIdMerchant* 상점 MID
10 byte
startDate* 지급 시작일 [YYYYMMDD]
8 byte
endDate* 지급 종료일 [YYYYMMDD]
8 byte
subMerchant 판매자 ID (서브몰 ID)
30 byte
clService 확정차수 구분 ["2": 당일지급 내역조회, 빈값은 익일지급 내역조회]
1 byte

STEP2송금결과 응답
전문예시

1 유형구분 1: 지급내역, 2: 환불내역
Number(2)
2 판매자 ID 판매자ID(서브몰) , 환불일경우 구매자ID
String(30)
3 사업자번호 사업자번호 (개인상점은 공백처리)
Number(10)
4 상호 상점명 (개인상점은 공백처리)
String(50)
5 사업주 사업자명 (개인상점은 공백처리)
String(20)
6 예금주
String(20)
7 은행코드
Number(2)
8 계좌번호
Number(20)
9 연락처
Number(20)
10 지급일 YYYYMMDD
Number(8)
11 지급액 지급한 금액
Number(12)
12 송금결과일 PG에서 송금한 일자 [YYYYMMDD]
송금결과에 대한 리턴값
Number(8)
13 결과코드 PG에서 송금한 결과코드 [01:성공, 02:실패]
송금결과에 대한 리턴값
String(2)

STEP1잔액대사 요청

잔액대사 요청정보

잔액대사 요청URL : https://iniweb.inicis.com/service/open/remit_funds.jsp

  • HTTP Method : GET / POST
  • Accept-charset : EUC-KR
strIdMerchant* 상점 MID
10 byte
startDate* 거래 시작일 [YYYYMMDD]
8 byte
endDate* 거래 종료일 [YYYYMMDD]
8 byte

STEP2잔액대사 응답
전문예시

상점ID 상점 MID
String(10)
사업자번호 사업자번호 (개인상점은 공백처리)
Number(10)
거래기간 조회 요청한 거래기간 [YYYYMMDDYYYYMMDD]
String(50)
잔액 요청거래기간의 잔액
Number(12)