연동준비하기 연동파라미터 규격
| INIAPI 샘플코드 | 취소/부분취소   | 빌링(정기과금)   | 에스크로   | 현금영수증   | 비인증결제   | 포인트결제   | 기타API      • 수동매입    • 거래조회    • 부분취소
     가능여부 조회

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

* 참고)  1. INIAPI 응답파라미터는 추후 요건에 의해 추가될 수 있습니다.
2. 실패 응답시 일부 파라미터 응답이 null 일 수 있습니다.

 
 
 

수동매입


파라미터 설명 필수(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(INIAPIKey+type+paymethod+timestamp+clientIp+mid+originalTid)
[ INIAPI Key 확인경로 ]
INIAPI Key 확인경로

1) INIAPI 연동 시 mid 파라미터에 세팅한 상점아이디로 가맹점관리자에 로그인 합니다.

2) 상단 메뉴에서 상점정보 > 계약정보 > 부가정보 로 이동합니다.

3) INIAPI key 생성 갱신 에서 "조회" 버튼을 클릭하여 INIAPI key 와 iv 값을 확인합니다.

4) INIAPI key 와 iv 값은 최초 생성 후 갱신하지 않습니다.
   (INIAPI 요청 시 key 와 iv 값이 상이한 경우 오류가 발생됩니다.)


동영상 가이드 확인하기
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(INIAPIKey+type+paymethod+timestamp+clientIp+mid)
[ INIAPI Key 확인경로 ]
INIAPI Key 확인경로

1) INIAPI 연동 시 mid 파라미터에 세팅한 상점아이디로 가맹점관리자에 로그인 합니다.

2) 상단 메뉴에서 상점정보 > 계약정보 > 부가정보 로 이동합니다.

3) INIAPI key 생성 갱신 에서 "조회" 버튼을 클릭하여 INIAPI key 와 iv 값을 확인합니다.

4) INIAPI key 와 iv 값은 최초 생성 후 갱신하지 않습니다.
   (INIAPI 요청 시 key 와 iv 값이 상이한 경우 오류가 발생됩니다.)


동영상 가이드 확인하기
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(INIAPIKey+type+paymethod+timestamp+clientIp+mid+originalTid)
[ INIAPI Key 확인경로 ]
INIAPI Key 확인경로

1) INIAPI 연동 시 mid 파라미터에 세팅한 상점아이디로 가맹점관리자에 로그인 합니다.

2) 상단 메뉴에서 상점정보 > 계약정보 > 부가정보 로 이동합니다.

3) INIAPI key 생성 갱신 에서 "조회" 버튼을 클릭하여 INIAPI key 와 iv 값을 확인합니다.

4) INIAPI key 와 iv 값은 최초 생성 후 갱신하지 않습니다.
   (INIAPI 요청 시 key 와 iv 값이 상이한 경우 오류가 발생됩니다.)


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