연동준비하기
• 연동가능환경 • 방화벽정보 • 대칭키 • HASH 방법 • AES 암호화

연동파라미터 규격
| INIAPI 샘플코드 | 취소/부분취소   | 빌링(정기과금)      • 빌링키발급    • 빌링승인
| 에스크로   | 현금영수증   | 비인증결제   | 포인트결제   | 기타API  


INIAPI


이니시스 빌링서비스 이용 시 빌링키발급, 빌링승인 등을 사용하기 위한 API 입니다.

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

 
빌링API Header

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

INIAPI 요청/응답형식

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

응답형식 : JSON

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

 
 
 

빌링키발급(비인증)


※ 인증방식 빌키발급은 PC(웹표준)결제모바일결제 모듈로 진행되어야 합니다.  ( 각 모듈의 "추가기능" 참조 )

** 해당 API는 비인증 방식으로 영업담당자를 통해 별도 계약 후 사용가능합니다.
    (비인증방식으로 계약되지 않은 MID 는 로그인처리 되지 않습니다.)
 
 
 

빌링승인


<<빌링승인 요청파라미터>>

파라미터 설명 필수(O/X) SIZE(Byte)
type "Billing" 고정 O 7
paymethod 지불수단 코드 [Card:신용카드, HPP:휴대폰] O 10
timestamp 전문생성시간 [YYYYMMDDhhmmss] O 14
clientIp 가맹점 요청 서버IP (추후 거래 확인 등에 사용됨) O 15
mid 상점아이디 O 10
url 가맹점 URL O 50
moid 가맹점주문번호 O 40
goodName 상품명 O 80
buyerName 구매자명 O 80
buyerEmail 구매자 이메일주소
* "@", "." 외 특수문자 입력불가
O 60
buyerTel 구매자 휴대폰번호 O 40
price 결제금액 O 10
tax 부가세
* "부가세 업체정함" 계약가맹점만 설정필요
X N/A
taxFree 비과세
* "부가세 업체정함" 계약가맹점만 설정필요
X N/A
billKey 승인요청할 빌링키 값 O 40
authentification 본인인증 여부 ["00" 고정] O 2
regNo 생년월일 [YYMMDD]   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 6
cardPw 카드비밀번호 앞 2자리   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 2
currency 통화코드 [WON,USD] X 3
cardQuota 할부기간 ["00":일시불, 그 외 : 02, 03 ...] X 2
quotaInterest 무이자구분 ["1":무이자] X 1
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+moid+price+billKey)
[ 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
payDate 거래일자 [YYYYMMDD] 8
payTime 거래시간 [hhmmss] 6
payAuthCode 승인번호 N/A
tid 결제승인 TID 40
price 거래금액 10
cardCode 카드코드   Code 2
cardQuota 할부개월 ["00":일시불, "02":2개월, "03":3개월, ...] 2
checkFlg 카드구분 ["0":신용, "1":체크, "2":기프트] 1
prtcCode 부분환불 가능여부 ["1": 가능, "0": 불가능] 1