정기과금(빌링) 서비스 가맹점에서 모바일 기기를 통한 빌링키발급 시 사용합니다.
빌키발급 후 빌링키를 이용한 결제 승인요청은 INIAPI 빌링승인을 참조하여 주시기 바랍니다.
※ 주의사항
1. 모바일빌링은 모바일 일반결제 서비스(mobile.inicis.com) 과 상이한 별도의 API 입니다.
이니라이트 상점으로 계약된 MID만 사용가능합니다. (빌링서비스 + 이니라이트 계약)
2. 모바일빌링 서비스는 모바일 device에 최적화 되어 있습니다.
- PC브라우저에서의 이상 작동은 확인이 불가합니다.
- PC 빌링키발급은 PC(웹표준)결제 서비스를 이용바랍니다.
방화벽정보
모바일빌링 서비스 통신을 위해서는 아래의 가맹점 방화벽이 허용되어 있어야합니다.
- 연결방향(가맹점기준) : OUTBOUND - PORT : 443 (https)
항목
URL
IP
운영환경
inilite.inicis.com
203.238.37.166
183.109.71.80
대칭키 (INILite key)
모바일빌링에서는 대칭키로 INILite key 를 사용하며 사용자 금액위변조 방지를 위해 HASH 값을 생성하여 대조할 때 사용됩니다.
INILite key 는 반드시 상점아이디(MID) 와 매칭되는 key 로 세팅하셔야 합니다.
×INILite key 확인경로
1) 이니라이트 기반 모듈 (모바일빌링,알리페이) 연동 시 mid 파라미터에 세팅한 상점아이디로 가맹점관리자에 로그인 합니다.
2) 상단 메뉴에서 상점정보 > 계약정보 > 부가정보 로 이동합니다.
3) INILite key 생성 갱신 에서 "조회" 버튼을 클릭하여 INILite key 값을 확인합니다.
4) INILite key 는 최초 생성 후 갱신하지 않습니다.
(이니라이트 모듈 결제요청 시 key 가 상이한 경우 오류가 발생됩니다.)
카드비밀번호 앞2자리 (AES256 암호화 후 UTF-8 URL Encode된 값)
example
×
모바일빌링 "data1" 파라미터 복호화 샘플
※ "data1" 값 복호화는 필수가 아니므로 가맹점 내부적으로 필요하신 경우에만 진행하시면 됩니다.
※ secretKey 는 INILitekey 를 사용합니다.
import javax.crypto.Cipher;
import javax.crypto.spec.IvParameterSpec;
import javax.crypto.spec.SecretKeySpec;
import sun.misc.BASE64Decoder;
import sun.misc.BASE64Encoder;
/**
* AES 암호화 샘플
* @author INICIS, MI1
*
*/
public class SampleCrypto
{
public static byte[] ivBytes = { 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00,
0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00 };
/**
* AES 복호화 함수
* @param secretKey // key 는 INILitekey 를 사용합니다.
* @param text
* @param charset
* @return
* @throws Exception
*/
public static String decryptAES(String secretKey, String text, String charset) throws
Exception {
IvParameterSpec iv = new IvParameterSpec(ivBytes);
SecretKeySpec spec = new SecretKeySpec(secretKey.getBytes(), "AES");
Cipher cipher = Cipher.getInstance("AES/CBC/PKCS5Padding");
cipher.init(Cipher.DECRYPT_MODE, spec, iv);
BASE64Decoder dec = new BASE64Decoder();
return new String(cipher.doFinal(dec.decodeBuffer(text)), charset);
}
}
* 특정가맹점만 사용
28
merchantreserved
상점 예약필드
1000
휴대폰 빌키발급
휴대폰 빌키발급 요청 시 사용되는 파라미터에 대하여 안내합니다.
※ 주의사항
휴대폰 빌링의 경우는 통신사 정책으로 빌키 발급시 인증+승인이 자동으로 됩니다.
2회차 부터는 1회차 동일금액, 익월+-5일이내 로 승인요청이 되어야 합니다.
휴대폰 빌링의 경우는 계약에 따라 회차 처리 로직이 다를 수 있으니 필히 계약 상태 확인후 진행바랍니다.
* 참고) 1. 모바일빌링 응답파라미터는 추후 요건에 의해 추가될 수 있습니다.
2. 실패 응답시 일부 파라미터 응답이 null 일 수 있습니다.