Web manual

거래조회

KG 이니시스 거래건을 조회하기 위한 API 서비스

개발 언어에 맞는 샘플을
다운로드 받아 주세요.

조회할 결제승인 TID 를 세팅해주세요.

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

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

거래조회 API 연동 전, 체크해야할 사항을 안내드립니다.

계약 완료 여부, 사용 가능 지불 수단 등은 계약담당자 문의

가맹점관리자 ▶ 상점정보 ▶ 계약정보 ▶ 부가정보 ▶ INIAPI key 생성조회

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*	지불수단 코드 ["Inquiry" 고정]	10 byte
timestamp*	전문생성시간 [YYYYMMDDhhmmss]	14 byte
clientIp*	가맹점 요청 서버IP (추후 거래 확인 등에 사용됨)	15 byte
mid*	상점아이디	10 byte
originalTid*	원 승인 거래 TID	40 byte
oid	주문번호 "주문번호 중복방지" 계약 시, originalTid 값 없이 oid 로만 거래조회 가능 가상계좌, 빌링(정기과금) 거래는 oid 를 통한 거래조회 기능 미지원 -> originalTid 로 조회 필요	80 byte
hashData*	SHA512 HASH 한 값 대상 : INIAPIKey + type + paymethod + timestamp + clientIp + mid	HASH 128 byte

해당 응답파라미터는 모든 프로세스 종료 후 최종적으로 전달되는 결과값 입니다.

resultCode	결과코드 "00":성공, 이외 실패	6 byte
resultMsg	결과메세지	100 byte
tid	거래번호	40 byte
price	거래금액	12 byte
status	거래상태 ["0":승인, "1":취소, "9":거래없음] 가상계좌 거래 시 ["N":입금대기, "Y":입금완료, "C":입금 전 취소]	1 byte
paymethod	지불수단 해외결제만 전달	10 byte
oid	주문번호 해외결제만 전달	80 byte
applNum	승인번호 해외결제만 전달	50 byte
priceExchange	원화승인금액 해외결제만 전달	byte
rtExchange	환율 해외결제만 전달 (은련카드 제외)	12 byte
applDate	승인일자 ISP결제만 전달	8 byte
applTime	승인시간 ISP결제만 전달	6 byte

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*	지불수단 코드 ["RepayChk" 고정]	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

해당 응답파라미터는 모든 프로세스 종료 후 최종적으로 전달되는 결과값 입니다.