상단으로 이동

KG이니시스

KG이니시스

정보등록

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

Quick Guide

서비스 신청

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

X-API-KEY 세팅

발급받은 X-API-KEY 를 세팅해주세요.

서브몰 계좌정보 확인

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

실행 및 결과확인

진행과정과
응답결과를 확인해 주세요.

연동 준비하기

지급대행 AML서비스 API 연동 전, 체크해야할 사항을 안내드립니다.

MID상점아이디
계약 완료 여부, 사용 가능 지불 수단 등은 계약담당자 문의
X-API-KEY 대칭키
가맹점관리자 ▶ 상점정보 ▶ 계약정보 ▶ KEY 정보 ▶ 부가서비스 연동 KEY 정보 ▶ 지급대행 서비스 ▶ [조회] 버튼 클릭

※ [조회] 버튼 미노출 시 계약담당자 문의

방화벽정보
항목 운영환경
URL apiwi.inicis.com
IP 118.129.210.143
183.109.71.186
PORT 443
연결방향 OUTBOUND
프로토콜 TLS 1.2 이상 지원
※ 스테이징 테스트 희망 시, 계약담당자 문의
(스테이징 환경에서는 서브몰 등록상태, 지급내역조회, 자금현황 등 조회 불가)

STEP1정보등록 요청

정보등록 요청정보

정보등록 요청URL : https://apiwi.inicis.com/rest/api/openmall/upsert

Header 정보

  • HTTP Method : POST
  • Content-Type : application/json;charset=utf-8
  • X-Request-ID * : API 통신 시 트래킹 ID로 Header에 필수값 필요
    참고사항
  • X-API-KEY * : 운영 환경에서의 맞는 API KEY 세팅 필요
idMerchant* MID(상점아이디)
10 byte
idMall* 판매자 ID
60 byte
clId* 판매자 유형 ["1": main mall, "2": sub mall]
1 byte
noComp 사업자번호
숫자만 허용
10 byte
nmComp* 상호명
50 byte
nmBoss* 대표자명
Base64 암호화 대상 파라미터
ENC
30 byte
nmRegist* 예금주명
Base64 암호화 대상 파라미터
ENC
50 byte
cdBank* 은행코드
은행코드
3 byte
noAcct* 계좌번호
Base64 암호화 대상 파라미터
ENC
20 byte
noTel* 휴대전화번호
Base64 암호화 대상 파라미터
ENC
20 byte
noEmail* 이메일주소
Base64 암호화 대상 파라미터
ENC
60 byte
bthDt* 생년월일
Base64 암호화 대상 파라미터
ENC
8 byte
svcDmlCd* 서비스구분코드 ["INS": 등록, "UPD": 수정]
(대,소문자 상관없음)
3 byte
svcType* 서비스타입 ["REQ": 지급요청, "REF": 환불요청]
(대,소문자 상관없음)
3 byte
userHash* 사용자위변조검증
대상 : 현재날짜 + idMerchant + base64 Decode(noAcct) + X-API-KEY
HASH
64 byte

STEP2정보등록 응답

code 결과코드
"SA01" 정상처리
상세코드
4 byte
msg 결과메세지
상세코드
N/A

지급요청

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

Quick Guide

서비스 신청

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

X-API-KEY 세팅

발급받은 X-API-KEY 를 세팅해주세요.

서브몰 계좌정보 확인

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

실행 및 결과확인

진행과정과
응답결과를 확인해 주세요.

연동 준비하기

지급대행 AML서비스 API 연동 전, 체크해야할 사항을 안내드립니다.

MID상점아이디
계약 완료 여부, 사용 가능 지불 수단 등은 계약담당자 문의
X-API-KEY대칭키
이니시스 영업담당자 통해 전달받은 X-API-KEY 사용
방화벽정보
항목 운영환경
URL apiwi.inicis.com
IP 118.129.210.143
183.109.71.186
PORT 443
연결방향 OUTBOUND
프로토콜 TLS 1.2 이상 지원
※ 스테이징 테스트 희망 시, 계약담당자 문의
(스테이징 환경에서는 서브몰 등록상태, 지급내역조회, 자금현황 등 조회 불가)

STEP1지급대행 요청

지급대행 요청정보

지급대행 요청URL : https://apiwi.inicis.com/rest/api/openmall/payreq

  • HTTP Method : POST
  • Content-Type : application/json;charset=utf-8
  • X-Request-ID * : API 통신 시 트래킹 ID로 Header에 필수값 필요
    참고사항
  • X-API-KEY * : 운영 환경에서의 맞는 API KEY 세팅 필요
idMerchant* MID(상점아이디)
10 byte
idMall* 판매자 ID
60 byte
dtPay* 지급일자 [YYYYMMDD]
숫자만 허용
8 byte
amtSupply* 지급금액
10 byte
clService* 차수구분 ["0": 익일지급, "2": 당일지급, "3": 비영업일]
3 byte
svcDmlCd* 서비스구분코드 ["INS": 등록, "DEL": 삭제]
(대,소문자 상관없음)
3 byte
svcType* 서비스타입 ["REQ": 지급요청, "REF": 환불요청]
(대,소문자 상관없음)
3 byte

STEP2지급대행 응답

code 결과코드
"SB01" 정상처리
상세코드
4 byte
msg 결과메세지
상세코드
N/A

송금결과 & 잔액대사

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

Quick Guide

서비스 신청

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

X-API-KEY 세팅

발급받은 X-API-KEY 를 세팅해주세요.

서브몰 정보 확인

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

실행 및 결과확인

진행과정과
응답결과를 확인해 주세요.

연동 준비하기

지급대행 AML서비스 API 연동 전, 체크해야할 사항을 안내드립니다.

MID상점아이디
계약 완료 여부, 사용 가능 지불 수단 등은 계약담당자 문의
X-API-KEY대칭키
이니시스 영업담당자 통해 전달받은 X-API-KEY 사용
방화벽정보
항목 운영환경
URL apiwi.inicis.com
IP 118.129.210.143
183.109.71.186
PORT 443
연결방향 OUTBOUND
프로토콜 TLS 1.2 이상 지원
※ 스테이징 테스트 희망 시, 계약담당자 문의
(스테이징 환경에서는 서브몰 등록상태, 지급내역조회, 자금현황 등 조회 불가)

STEP1송금결과 조회 요청

송금결과 요청정보

송금결과 조회 요청URL : https://apiwi.inicis.com/rest/api/openmall/payresult

Header 정보

  • HTTP Method : GET
  • Content-Type : application/json;charset=utf-8
  • X-Request-ID * : API 통신 시 트래킹 ID로 Header에 필수값 필요
    참고사항
  • X-API-KEY * : 운영 환경에서의 맞는 API KEY 세팅 필요
idMerchant* 상점MID
10 byte
idMall 판매자ID
10 byte
startDtPay* 시작지급일자 [YYYYMMDD]
8 byte
endDtPay* 종료지급일자 [YYYYMMDD]
8 byte
clService* 차수구분 ["0": 익일지급, "2": 당일지급, "3": 비영업일]
3 byte
svcType* 서비스타입 ["REQ": 지급요청, "REF": 환불요청]
(대,소문자 상관없음)
3 byte

STEP2송금결과 응답
전문예시

code 결과코드
"SC01" 정상처리
상세코드
4 byte
msg 결과메세지
상세코드
N/A
data 상세
svcType 유형구분
3 byte
idMall 판매자ID
60 byte
noComp 사업자번호
10 byte
nmComp 상호명
50 byte
nmBoss 사업주
30 byte
nmRegist 예금주
50 byte
cdBank 은행코드
3 byte
noAcct 계좌번호
20 byte
noTel 연락처
20 byte
dtPay 지급일
8 byte
amtSupply 지급액
10 byte
remitDtPay 송금결과일
8 byte
clPay 결과코드
2 byte

STEP1잔액대사 요청

잔액대사 요청정보

잔액대사 요청URL : https://apiwi.inicis.com/rest/api/openmall/paycheck

  • HTTP Method : GET
  • Content-Type : application/json;charset=utf-8
  • X-Request-ID * : API 통신 시 트래킹 ID로 Header에 필수값 필요
    참고사항
  • X-API-KEY * : 운영 환경에서의 맞는 API KEY 세팅 필요
idMerchant* 상점 MID
10 byte
startDtPay* 시작지급일자 [YYYYMMDD]
8 byte
endDtPay* 종료지급일자 [YYYYMMDD]
8 byte

STEP2잔액대사 응답
전문예시

code 결과코드
"SD01" 정상처리
상세코드
4 byte
msg 결과메세지
상세코드
N/A
data 상세
noComp 사업자번호
10 byte
totalAmt 잔액
12 byte
idMerchant 상점MID
10 byte
payTransDt 조회 요청 거래기간
16 byte

서브몰 AML 상태 조회

KG이니시스를 통한 서브몰 AML 상태 확인 API 서비스

Quick Guide

서비스 신청

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

X-API-KEY 세팅

발급받은 X-API-KEY 를 세팅해주세요.

서브몰 정보 확인

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

실행 및 결과확인

진행과정과
응답결과를 확인해 주세요.

연동 준비하기

지급대행 AML서비스 API 연동 전, 체크해야할 사항을 안내드립니다.

MID상점아이디
계약 완료 여부, 사용 가능 지불 수단 등은 계약담당자 문의
X-API-KEY대칭키
이니시스 영업담당자 통해 전달받은 X-API-KEY 사용
방화벽정보
항목 운영환경
URL apiwi.inicis.com
IP 118.129.210.143
183.109.71.186
PORT 443
연결방향 OUTBOUND
프로토콜 TLS 1.2 이상 지원
※ 스테이징 테스트 희망 시, 계약담당자 문의
(스테이징 환경에서는 서브몰 등록상태, 지급내역조회, 자금현황 등 조회 불가)

STEP1서브몰 AML 상태 조회 요청

송금결과 요청정보

송금결과 조회 요청URL : https://apiwi.inicis.com/rest/api/openmall/amlstatus

Header 정보

  • HTTP Method : GET
  • Content-Type : application/json;charset=utf-8
  • X-Request-ID * : API 통신 시 트래킹 ID로 Header에 필수값 필요
    참고사항
  • X-API-KEY * : 운영 환경에서의 맞는 API KEY 세팅 필요
idMerchant* 상점MID
10 byte
idMall* 판매자ID
10 byte
svcType* 서비스타입 ["REQ": 지급요청, "REF": 환불요청]
(대,소문자 상관없음)
3 byte

STEP2서브몰 AML 상태 조회 응답
전문예시

code 결과코드
"SM01" 정상처리
상세코드
4 byte
msg 결과메세지
상세코드
N/A
data 상세
amlExmnYn AML 심사상태
코드리스트
1 byte
amlReExecToDt 이행유효종료일자
8 byte
amlConm 상호명
50 byte
amlCeoNm 대표자명
30 byte
amlAuthExpiredYn AML인증만료여부 ["Y": 정상, "N": 만료]
1 byte
amlReExecFromDt 이행유효시작일자
8 byte
reAmlExmnYn 재이행진행상태
1 byte
amlTransmDt 심사완료일자
8 byte
amlDtsNo 사업자번호
10 byte