KG INICIS MANUAL

INIAPI

이니시스 결제의 수동매입,거래조회 등 기타서비스를 사용하기 위한 API 입니다.

해당 서비스는 OPEN API형태로 구성되어 있으며, 연동 시 상세파라미터 규격에 대하여 안내합니다.

기타API Header

POST /api/v1/extra HTTP/1.1
Host: iniapi.inicis.com
Content-type: application/x-www-form-urlencoded;charset=utf-8

API URL: https://iniapi.inicis.com/api/v1/extra

INIAPI 요청/응답형식

요청형식 : 각 파라미터를 key=value 로 세팅하여 POST로 API 요청 ( JSON방식 요청불가 )
Form data 세팅 후 API 통신 구간에서 전체 URLencode 하여 전송

응답형식 : JSON

* 참고) INIAPI 응답파라미터는 추후 요건에 의해 추가될 수 있습니다.

수동매입

요청파라미터
응답파라미터

파라미터	설명	필수(O/X)	SIZE(Byte)
type	"Extra" 고정	O	6
paymethod	"Capture" 고정	O	10
timestamp	전문생성시간 [YYYYMMDDhhmmss]	O	14
clientIp	가맹점 요청 서버IP (추후 거래 확인 등에 사용됨)	O	15
mid	상점아이디	O	10
originalTid	원거래 TID	O	40
hashData	전문위변조 HASH `HASH` × hashData 개요 HASH 알고리즘: SHA-512 대상파라미터 : 각 서비스API 별로 상이 1> SHA-512 사용합니다. 2> INIAPI key 를 사용합니다. SHA512 HASH 생성 확인하기 ※ Hash 암호화 데이터 설정의 예시 __ 카드취소 기준 type = Refund paymethod = Card timestamp = 20191128121211 clientIp = 123.123.123.123 mid = INIpayTest tid = StdpayCARDINIpayTest20191128121211123456 msg = 테스트 hashData = b2dc4d4308d836a77187fa1f4ce8c540006a41e6a708a63aded363510c7d445600601c9035825fe32f48fe1b7d2ea130f690a2895a41b6fa0a99c6c5f92d6d69 (PlainText : ItEQKi3rY7uvDS8lRefundCard 20191128121211123.123.123.123INIpayTest StdpayCARDINIpayTest20191128121211123456) 관련 웹매뉴얼로 이동하기 hash(KEY+type+paymethod+timestamp+clientIp+mid+originalTid)	O	128

파라미터	설명	SIZE(Byte)
resultCode	결과코드["00":성공, 그외 실패]	6
resultMsg	결과메세지	100
tid	거래 TID	40

거래조회

요청파라미터
응답파라미터

파라미터	설명	필수(O/X)	SIZE(Byte)
type	"Extra" 고정	O	6
paymethod	"Inquiry" 고정	O	10
timestamp	전문생성시간 [YYYYMMDDhhmmss]	O	14
clientIp	가맹점 요청 서버IP (추후 거래 확인 등에 사용됨)	O	15
mid	상점아이디	O	10
originalTid	원거래 TID	O	40
oid	주문번호 * "주문번호 중복방지" 계약 시, originalTid 값 없이 oid 로만 거래조회 가능	X	80
hashData	전문위변조 HASH `HASH` × hashData 개요 HASH 알고리즘: SHA-512 대상파라미터 : 각 서비스API 별로 상이 1> SHA-512 사용합니다. 2> INIAPI key 를 사용합니다. SHA512 HASH 생성 확인하기 ※ Hash 암호화 데이터 설정의 예시 __ 카드취소 기준 type = Refund paymethod = Card timestamp = 20191128121211 clientIp = 123.123.123.123 mid = INIpayTest tid = StdpayCARDINIpayTest20191128121211123456 msg = 테스트 hashData = b2dc4d4308d836a77187fa1f4ce8c540006a41e6a708a63aded363510c7d445600601c9035825fe32f48fe1b7d2ea130f690a2895a41b6fa0a99c6c5f92d6d69 (PlainText : ItEQKi3rY7uvDS8lRefundCard 20191128121211123.123.123.123INIpayTest StdpayCARDINIpayTest20191128121211123456) 관련 웹매뉴얼로 이동하기 hash(KEY+type+paymethod+timestamp+clientIp+mid)	O	128

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

부분취소 가능여부 조회

요청파라미터
응답파라미터

파라미터	설명	필수(O/X)	SIZE(Byte)
type	"Extra" 고정	O	6
paymethod	"RepayChk" 고정	O	10
timestamp	전문생성시간 [YYYYMMDDhhmmss]	O	14
clientIp	가맹점 요청 서버IP (추후 거래 확인 등에 사용됨)	O	15
mid	상점아이디	O	10
originalTid	원거래 TID	O	40
hashData	전문위변조 HASH `HASH` × hashData 개요 HASH 알고리즘: SHA-512 대상파라미터 : 각 서비스API 별로 상이 1> SHA-512 사용합니다. 2> INIAPI key 를 사용합니다. SHA512 HASH 생성 확인하기 ※ Hash 암호화 데이터 설정의 예시 __ 카드취소 기준 type = Refund paymethod = Card timestamp = 20191128121211 clientIp = 123.123.123.123 mid = INIpayTest tid = StdpayCARDINIpayTest20191128121211123456 msg = 테스트 hashData = b2dc4d4308d836a77187fa1f4ce8c540006a41e6a708a63aded363510c7d445600601c9035825fe32f48fe1b7d2ea130f690a2895a41b6fa0a99c6c5f92d6d69 (PlainText : ItEQKi3rY7uvDS8lRefundCard 20191128121211123.123.123.123INIpayTest StdpayCARDINIpayTest20191128121211123456) 관련 웹매뉴얼로 이동하기 hash(KEY+type+paymethod+timestamp+clientIp+mid+originalTid)	O	128

파라미터	설명	SIZE(Byte)
resultCode	결과코드["00":성공, 그외 실패]	6
resultMsg	결과메세지	100
tid	거래TID	40
prtcCheckRemains	부분취소 잔액	12
prtcCheckCnt	부분취소 진행 누적회차	4
partCheckCode	부분취소 가능여부 ["0": 불가능, "1": 가능]	1