연동준비하기 연동파라미터 규격
| INIAPI 샘플코드 | 취소/부분취소  ▼    • 일반취소    • 가상계좌 환불    • 휴대폰(익월) 환불
| 빌링(정기과금)  ▼ | 에스크로  ▼ | 현금영수증  ▼ | 비인증결제  ▼ | 포인트결제  ▼ | 기타API  ▼

INIAPI


이니시스 결제의 취소/부분취소 등을 사용하기 위한 API 입니다.

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

 
취소API Header

POST /api/v1/refund 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/refund

INIAPI 요청/응답형식

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

응답형식 : JSON

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

일반취소/부분취소


<<전체취소 요청파라미터>>

파라미터 설명 필수(O/X) SIZE(Byte)
type "Refund" 고정 O 6
paymethod 지불수단 코드   Info O 10
timestamp 전문생성시간 [YYYYMMDDhhmmss] O 14
clientIp 가맹점 요청 서버IP (추후 거래 확인 등에 사용됨) O 15
mid 상점아이디 O 10
tid 취소요청 승인TID O 40
msg 취소요청사유 O 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+tid)		 O 128

<<전체취소 응답파라미터>>

파라미터 설명 SIZE(Byte)
resultCode 결과코드["00":성공, 그외 실패] 6
resultMsg 결과메세지 100
cancelDate 취소일자 [YYYYMMDD] 8
cancelTime 취소시간 [hhmmss] 6
cshrCancelNum 현금영수증 취소승인번호
* 현금영수증 발행건에 한함		 9
<<부분취소 요청파라미터>>

파라미터 설명 필수(O/X) SIZE(Byte)
type "PartialRefund" 고정 O 6
paymethod 지불수단 코드   Info
×

지불수단코드


지불수단 Value
신용카드 Card
실시간계좌이체 Acct
가상계좌 Vacct
휴대폰 HPP
상품권 Voucher
페이팔 Paypal
알리페이 Apay
O 10
timestamp 전문생성시간 [YYYYMMDDhhmmss] O 14
clientIp 가맹점 요청 서버IP (추후 거래 확인 등에 사용됨) O 15
mid 상점아이디 O 10
tid 취소요청 승인TID O 40
msg 취소요청사유 O 80
price 취소요청금액 O 12
confirmPrice 부분취소 후 남은금액 O 12
currency 통화코드 [WON,USD] X 3
tax 부과세 X 12
taxFree 비과세 X 12
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+tid+price+confirmPrice)		 O 128

<<부분취소 응답파라미터>>

파라미터 설명 SIZE(Byte)
resultCode 결과코드["00":성공, 그외 실패] 6
resultMsg 결과메세지 100
tid 부분취소TID 40
prtcTid 원거래TID 40
prtcPrice 부분취소금액 12
prtcRemains 부분취소 후 남은금액 12
prtcCnt 부분취소 요청 횟수 2
prtcType 부분취소 구분 ["0":재승인방식, "1":부분취소] 1
prtcDate 부분취소일자 [YYYYMMDD] 8
prtcTime 부분취소시간 [hhmmss] 6
 
 
 

가상계좌 환불/부분환불


<<가상계좌 환불 요청파라미터>>

파라미터 설명 필수(O/X) SIZE(Byte)
type "Refund" 고정 O 6
paymethod "Vacct" 고정 O 10
timestamp 전문생성시간 [YYYYMMDDhhmmss] O 14
clientIp 가맹점 요청 서버IP (추후 거래 확인 등에 사용됨) O 15
mid 상점아이디 O 10
tid 취소요청 승인TID O 40
msg 취소요청사유 O 80
refundAcctNum 환불계좌번호   ENC
×
AES 암호화

암호화 알고리즘 :  AES(AES/CBC/PKCS5Padding)

대상파라미터 :  ENC 표기된 파라미터 value 값

     1> AES암호화는 128-cbc 방식입니다.
     2> INIAPI key 와 iv 를 사용합니다.


AES암호화 생성 확인하기

※ AES 암호화 데이터 설정 시 유의사항

hashData 생성 시, AES암호화 한 값으로 SHA512 hash 합니다.


    ex) 현금영수증 API 기준

    PlainText : 01011112222                              // 현금영수증 식별번호
    regNum : 5l8uENBFbTe50/9F3/7o0g==      // regNum 파라미터에 AES암호화 한 데이터를 세팅

    hashData : e55083c6e4d492b0f4c3f3145348c20d9d9d8fbafbe530245e77ea4db824d81a412073195f86110224568c613efd146bada7755b2113fa94a82007ce1795e8c8

    (PlainText : ItEQKi3rY7uvDS8lIssueReceipt20191128121211123.123.123.123INIpayTest10001001005l8uENBFbTe50/9F3/7o0g==)



관련 웹매뉴얼로 이동하기
O 40
refundBankCode 환불계좌 은행코드   Code
×

은행코드


코드 은행사 코드 은행사
02 한국산업은행 03 기업은행
05 하나은행 (구. 외환) 06 국민은행 (구. 주택)
07 수협중앙회 11 농협중앙회
12 단위농협 16 축협중앙회
20 우리은행 21 구)조흥은행
22 상업은행 23 SC제일은행
24 한일은행 25 서울은행
26 구)신한은행 27 한국씨티은행 (구. 한미)
31 대구은행 32 부산은행
34 광주은행 35 제주은행
37 전북은행 38 강원은행
39 경남은행 41 비씨카드
48 신용협동조합중앙회 50 상호저축은행
53 한국씨티은행 54 홍콩상하이은행
55 도이치은행 56 ABN암로
57 JP모건 59 미쓰비시도쿄은행
60 BOA(Bank of America) 64 산림조합
70 신안상호저축은행 71 우체국
81 하나은행 83 평화은행
87 신세계 88 신한(통합)은행
89 케이뱅크 90 카카오뱅크
93 토스머니 (포인트 100% 사용) 94 SSG머니 (포인트 100% 사용)
96 엘포인트 (포인트 100% 사용) 97 카카오머니
98 페이코 (포인트 100% 사용)

금융사코드 확인하러 가기
O 2
refundAcctName 환불계좌 예금주명 O 20
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+tid+refundAcctNum)		 O 128

<<가상계좌 환불 응답파라미터>>

파라미터 설명 SIZE(Byte)
resultCode 결과코드["00":성공, 그외 실패] 6
resultMsg 결과메세지 100
cancelDate 취소일자 [YYYYMMDD] 8
cancelTime 취소시간 [hhmmss] 6
cshrCancelNum 현금영수증 취소승인번호
* 현금영수증 발행건에 한함		 9
<<가상계좌 부분환불 요청파라미터>>

파라미터 설명 필수(O/X) SIZE(Byte)
type "PartialRefund" 고정 O 6
paymethod "Vacct" 고정 O 10
timestamp 전문생성시간 [YYYYMMDDhhmmss] O 14
clientIp 가맹점 요청 서버IP (추후 거래 확인 등에 사용됨) O 15
mid 상점아이디 O 10
tid 취소요청 승인TID O 40
msg 취소요청사유 O 80
price 취소요청금액 O 12
confirmPrice 부분취소 후 남은금액 O 12
refundAcctNum 환불계좌번호   ENC
×
AES 암호화

암호화 알고리즘 :  AES(AES/CBC/PKCS5Padding)

대상파라미터 :  ENC 표기된 파라미터 value 값

     1> AES암호화는 128-cbc 방식입니다.
     2> INIAPI key 와 iv 를 사용합니다.


AES암호화 생성 확인하기

※ AES 암호화 데이터 설정 시 유의사항

hashData 생성 시, AES암호화 한 값으로 SHA512 hash 합니다.


    ex) 현금영수증 API 기준

    PlainText : 01011112222                              // 현금영수증 식별번호
    regNum : 5l8uENBFbTe50/9F3/7o0g==      // regNum 파라미터에 AES암호화 한 데이터를 세팅

    hashData : e55083c6e4d492b0f4c3f3145348c20d9d9d8fbafbe530245e77ea4db824d81a412073195f86110224568c613efd146bada7755b2113fa94a82007ce1795e8c8

    (PlainText : ItEQKi3rY7uvDS8lIssueReceipt20191128121211123.123.123.123INIpayTest10001001005l8uENBFbTe50/9F3/7o0g==)



관련 웹매뉴얼로 이동하기
O 40
refundBankCode 환불계좌 은행코드   Code
×

은행코드


코드 은행사 코드 은행사
02 한국산업은행 03 기업은행
05 하나은행 (구. 외환) 06 국민은행 (구. 주택)
07 수협중앙회 11 농협중앙회
12 단위농협 16 축협중앙회
20 우리은행 21 구)조흥은행
22 상업은행 23 SC제일은행
24 한일은행 25 서울은행
26 구)신한은행 27 한국씨티은행 (구. 한미)
31 대구은행 32 부산은행
34 광주은행 35 제주은행
37 전북은행 38 강원은행
39 경남은행 41 비씨카드
48 신용협동조합중앙회 50 상호저축은행
53 한국씨티은행 54 홍콩상하이은행
55 도이치은행 56 ABN암로
57 JP모건 59 미쓰비시도쿄은행
60 BOA(Bank of America) 64 산림조합
70 신안상호저축은행 71 우체국
81 하나은행 83 평화은행
87 신세계 88 신한(통합)은행
89 케이뱅크 90 카카오뱅크
93 토스머니 (포인트 100% 사용) 94 SSG머니 (포인트 100% 사용)
96 엘포인트 (포인트 100% 사용) 97 카카오머니
98 페이코 (포인트 100% 사용)

금융사코드 확인하러 가기
O 2
refundAcctName 환불계좌 예금주명 O 20
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+tid+price+confirmPrice+refundAcctNum)		 O 128

<<가상계좌 부분환불 응답파라미터>>

파라미터 설명 SIZE(Byte)
resultCode 결과코드["00":성공, 그외 실패] 6
resultMsg 결과메세지 100
tid 부분환불TID 40
prtcTid 원거래TID 40
prtcPrice 부분환불금액 12
prtcRemains 부분환불 후 남은금액 12
prtcCnt 부분취소 요청 횟수 2
 
 
 

휴대폰(익월)환불/부분환불

휴대폰 익월 환불/부분환불은 영업담당자를 통해 별도 계약 후 사용가능합니다.


<<휴대폰(익월)환불 요청파라미터>>

파라미터 설명 필수(O/X) SIZE(Byte)
type "Refund" 고정 O 6
paymethod "HPP" 고정 O 10
timestamp 전문생성시간 [YYYYMMDDhhmmss] O 14
clientIp 가맹점 요청 서버IP (추후 거래 확인 등에 사용됨) O 15
mid 상점아이디 O 10
tid 취소요청 승인TID O 40
msg 취소요청사유 O 80
refundAcctNum 환불계좌번호   ENC
×
AES 암호화

암호화 알고리즘 :  AES(AES/CBC/PKCS5Padding)

대상파라미터 :  ENC 표기된 파라미터 value 값

     1> AES암호화는 128-cbc 방식입니다.
     2> INIAPI key 와 iv 를 사용합니다.


AES암호화 생성 확인하기

※ AES 암호화 데이터 설정 시 유의사항

hashData 생성 시, AES암호화 한 값으로 SHA512 hash 합니다.


    ex) 현금영수증 API 기준

    PlainText : 01011112222                              // 현금영수증 식별번호
    regNum : 5l8uENBFbTe50/9F3/7o0g==      // regNum 파라미터에 AES암호화 한 데이터를 세팅

    hashData : e55083c6e4d492b0f4c3f3145348c20d9d9d8fbafbe530245e77ea4db824d81a412073195f86110224568c613efd146bada7755b2113fa94a82007ce1795e8c8

    (PlainText : ItEQKi3rY7uvDS8lIssueReceipt20191128121211123.123.123.123INIpayTest10001001005l8uENBFbTe50/9F3/7o0g==)



관련 웹매뉴얼로 이동하기

* 익월환불의 경우		 X 40
refundBankCode 환불계좌 은행코드   Code
×

은행코드


코드 은행사 코드 은행사
02 한국산업은행 03 기업은행
05 하나은행 (구. 외환) 06 국민은행 (구. 주택)
07 수협중앙회 11 농협중앙회
12 단위농협 16 축협중앙회
20 우리은행 21 구)조흥은행
22 상업은행 23 SC제일은행
24 한일은행 25 서울은행
26 구)신한은행 27 한국씨티은행 (구. 한미)
31 대구은행 32 부산은행
34 광주은행 35 제주은행
37 전북은행 38 강원은행
39 경남은행 41 비씨카드
48 신용협동조합중앙회 50 상호저축은행
53 한국씨티은행 54 홍콩상하이은행
55 도이치은행 56 ABN암로
57 JP모건 59 미쓰비시도쿄은행
60 BOA(Bank of America) 64 산림조합
70 신안상호저축은행 71 우체국
81 하나은행 83 평화은행
87 신세계 88 신한(통합)은행
89 케이뱅크 90 카카오뱅크
93 토스머니 (포인트 100% 사용) 94 SSG머니 (포인트 100% 사용)
96 엘포인트 (포인트 100% 사용) 97 카카오머니
98 페이코 (포인트 100% 사용)

금융사코드 확인하러 가기

* 익월환불의 경우		 X 2
refundAcctName 환불계좌 예금주명
* 익월환불의 경우		 X 20
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+tid+refundAcctNum)		 O 128

<<휴대폰(익월)환불 응답파라미터>>

파라미터 설명 SIZE(Byte)
resultCode 결과코드["00":성공, 그외 실패] 6
resultMsg 결과메세지 100
cancelDate 취소일자 [YYYYMMDD] 8
cancelTime 취소시간 [hhmmss] 6
<<휴대폰(익월)부분환불 요청파라미터>>

파라미터 설명 필수(O/X) SIZE(Byte)
type "PartialRefund" 고정 O 6
paymethod "HPP" 고정 O 10
timestamp 전문생성시간 [YYYYMMDDhhmmss] O 14
clientIp 가맹점 요청 서버IP (추후 거래 확인 등에 사용됨) O 15
mid 상점아이디 O 10
tid 환불요청 승인TID O 40
msg 환불요청사유 O 80
price 환불요청금액 O 12
confirmPrice 부분환불 후 남은금액 O 12
refundAcctNum 환불계좌번호   ENC
×
AES 암호화

암호화 알고리즘 :  AES(AES/CBC/PKCS5Padding)

대상파라미터 :  ENC 표기된 파라미터 value 값

     1> AES암호화는 128-cbc 방식입니다.
     2> INIAPI key 와 iv 를 사용합니다.


AES암호화 생성 확인하기

※ AES 암호화 데이터 설정 시 유의사항

hashData 생성 시, AES암호화 한 값으로 SHA512 hash 합니다.


    ex) 현금영수증 API 기준

    PlainText : 01011112222                              // 현금영수증 식별번호
    regNum : 5l8uENBFbTe50/9F3/7o0g==      // regNum 파라미터에 AES암호화 한 데이터를 세팅

    hashData : e55083c6e4d492b0f4c3f3145348c20d9d9d8fbafbe530245e77ea4db824d81a412073195f86110224568c613efd146bada7755b2113fa94a82007ce1795e8c8

    (PlainText : ItEQKi3rY7uvDS8lIssueReceipt20191128121211123.123.123.123INIpayTest10001001005l8uENBFbTe50/9F3/7o0g==)



관련 웹매뉴얼로 이동하기

* 익월환불의 경우		 X 40
refundBankCode 환불계좌 은행코드   Code
×

은행코드


코드 은행사 코드 은행사
02 한국산업은행 03 기업은행
05 하나은행 (구. 외환) 06 국민은행 (구. 주택)
07 수협중앙회 11 농협중앙회
12 단위농협 16 축협중앙회
20 우리은행 21 구)조흥은행
22 상업은행 23 SC제일은행
24 한일은행 25 서울은행
26 구)신한은행 27 한국씨티은행 (구. 한미)
31 대구은행 32 부산은행
34 광주은행 35 제주은행
37 전북은행 38 강원은행
39 경남은행 41 비씨카드
48 신용협동조합중앙회 50 상호저축은행
53 한국씨티은행 54 홍콩상하이은행
55 도이치은행 56 ABN암로
57 JP모건 59 미쓰비시도쿄은행
60 BOA(Bank of America) 64 산림조합
70 신안상호저축은행 71 우체국
81 하나은행 83 평화은행
87 신세계 88 신한(통합)은행
89 케이뱅크 90 카카오뱅크
93 토스머니 (포인트 100% 사용) 94 SSG머니 (포인트 100% 사용)
96 엘포인트 (포인트 100% 사용) 97 카카오머니
98 페이코 (포인트 100% 사용)

금융사코드 확인하러 가기

* 익월환불의 경우		 X 2
refundAcctName 환불계좌 예금주명
* 익월환불의 경우		 X 20
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+tid+price+confirmPrice+refundAcctNum)		 O 128

<<휴대폰(익월)부분환불 응답파라미터>>

파라미터 설명 SIZE(Byte)
resultCode 결과코드["00":성공, 그외 실패] 6
resultMsg 결과메세지 100
tid 부분환불TID 40
prtcTid 원거래TID 40
prtcPrice 부분환불금액 12
prtcRemains 부분환불 후 남은금액 12
prtcCnt 부분취소 요청 횟수 2
prtcDate 부분환불 일자 [YYYYMMDD] 8
prtcTime 부분환불 시간 [hhmmss] 6