수동매입 ※ 별도 계약필요(영업담당자 문의)
KG 이니시스 거래건을 수동매입 처리하기 위한 API 서비스
Quick Guide
샘플 다운로드
개발 언어에 맞는 샘플을
다운로드 받아 주세요.
결제승인 TID 세팅
수동매입할 결제승인 TID 를 세팅해주세요.
테스트 실행 및 결과확인
결제 진행과정과
응답결과를 확인해 주세요.
실제 연동진행
가맹점 실서버 환경에 맞게
연동을 진행해주세요.
연동 준비하기
수동매입 API 연동 전, 체크해야할 사항을 안내드립니다.
MID상점아이디
계약 완료 여부, 사용 가능 지불 수단 등은 계약담당자 문의INIAPI key대칭키
가맹점관리자 ▶ 상점정보 ▶ 계약정보 ▶ 부가정보 ▶ INIAPI key 생성조회방화벽정보
항목 | 스테이징환경 | 운영환경 |
---|---|---|
URL | stginiapi.inicis.com | iniapi.inicis.com |
IP | 118.129.210.153 | 118.129.210.166 183.109.71.79 |
PORT | 443 | |
연결방향 | OUTBOUND | |
프로토콜 | TLS 1.2 이상 지원 |
STEP1수동매입 요청
수동매입 요청정보
- 수동매입 URL : https://iniapi.inicis.com/api/v1/extra
- Header 정보
POST /api/v1/extra HTTP/1.1
Host: iniapi.inicis.com
Content-type: application/x-www-form-urlencoded;charset=utf-8
- 유의사항
각 파라미터는 key=value 로 세팅하여 POST 로 API 요청 ( JSON방식 요청불가 )
Form data 세팅 후 API 통신 구간에서 모든 value를 urlEncode 하여 전송
type* | 요청서비스 ["Extra" 고정] |
7 byte
|
---|---|---|
paymethod* | 지불수단 코드 ["Capture" 고정] |
10 byte
|
timestamp* | 전문생성시간 [YYYYMMDDhhmmss] |
14 byte
|
clientIp* | 가맹점 요청 서버IP (추후 거래 확인 등에 사용됨) |
15 byte
|
mid* | 상점아이디 |
10 byte
|
originalTid* | 원 승인 거래 TID |
40 byte
|
hashData* | SHA512 HASH 한 값 대상 : INIAPIKey + type + paymethod + timestamp + clientIp + mid + originalTid |
HASH
128 byte
|
STEP2수동매입 응답
※ 유의사항
해당 응답파라미터는 모든 프로세스 종료 후 최종적으로 전달되는 결과값 입니다.
- 응답파라미터는 추후 요건에 의해 추가될 수 있습니다.
- 실패 응답 시, 일부 파라미터 응답이 null 일 수 있습니다.
- 응답형식은 JSON 형식 입니다.
resultCode | 결과코드 "00":성공, 이외 실패 |
6 byte
|
---|---|---|
resultMsg | 결과메세지 |
100 byte
|
reqData | 처리일자 |
8 byte
|
reqTime | 처리시간 |
6 byte
|