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

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


INIAPI


이니시스 결제의 취소/부분취소, 현금영수증 발행 등을 사용하기 위한 API 입니다.

해당 서비스는 OPEN API형태로 구성되어 있으며, 서비스 연동을 위한 환경정보 안내드립니다.

 
 
 

연동가능환경


소프트웨어 요구사항 :

HTTPS 통신이 가능한 웹서버 (또는 웹 컨테이너)
* SHA512 Hash, AES암호화 값 생성, httpClient (HTTP Background) 통신이 가능한지 확인

하드웨어 요구사항 :

일반적인 서버 운영체제의 운용환경에 준하며, 특별한 하드웨어 요구사항은 없습니다.

 
 
 

방화벽정보


INIAPI 서비스 통신을 위해서는 아래의 가맹점 방화벽이 허용되어 있어야합니다.


- 연결방향(가맹점기준) : OUTBOUND
- PORT : 443 (https)

항목 URL IP 비고
스테이징 환경 stginiapi.inicis.com 118.129.210.153 테스트MID 만 사용가능
운영환경 iniapi.inicis.com 118.129.210.166
183.109.71.79
 
 
 

대칭키 (INIAPI key)


INIAPI는 대칭키로 "INIAPI key"를 사용하며 전문 위변조 방지를 위해 HASH 값을 생성하여 대조할 때 사용됩니다.

INIAPI key 는 반드시 상점아이디(MID) 와 매칭되는 key 로 세팅하셔야 합니다.   


<< 테스트MID 대칭키 >>

용도 MID INIAPI key IV
일반결제 INIpayTest ItEQKi3rY7uvDS8l HYb3yQ4f65QL89==
빌링결제(정기과금) INIBillTst rKnPljRn5m6J9Mzz W2KLNKra6Wxc1P==
에스크로결제 iniescrow0 yERbIlJ3NhTeObsA tOGDXbfoajk2DQ==

※ 테스트MID 사용 시 유의사항

 - 결제테스트 시 지불수단별로 거래가 실승인 됩니다.

 - 테스트 MID 로 진행한 거래건은 당일 자정 이전에 자동취소 됩니다. (매입전송X)
    (부분취소 진행건은 정상취소 되지 않을 수 있으므로 부분취소 테스트는 권장하지 않음)

 - 국민카드사 정책상, 국민카드 (카카오뱅크카드 포함) 는 카카오페이 결제테스트, 빌링키발급 테스트 가 불가합니다.

 
 
 

HASH 방법


결제요청/승인요청 시 사용자의 위변조 방지를 위해 일부데이터를 SHA512 로 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)

 
 
 

AES 암호화


INIAPI는 주요 데이터는 AES 암호화하여 전송합니다. 암호화 알고리즘은 AES(AES/CBC/PKCS5Padding)를 사용합니다.

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==)