모듈연동 FAQ

모듈연동 FAQ

KG이니시스와 전자결제서비스에 대한 새로운 소식을 알려드립니다.
언제나 고객님께 가치 있는 소식을 전할 수 있도록 노력하겠습니다.

1. 빌링승인 요청 시 billkey 발급 당시 사용한 MID 와 다른 MID 로 승인요청하는 경우 오류발생

billkey 발급 당시 세팅한 MID 확인 후 승인요청 시에도 동일한 MID 를 세팅하였는지, billkey 값이 정상세팅된 것이 맞는지 확인바랍니다.

2. INIAPI 를 통한 빌링승인요청 시 운영계로 빌키발급 후 개발계로 빌링승인요청 하는 경우 오류발생

빌키발급 요청을 운영환경으로 진행한 경우, 빌링승인요청도 운영환경URL 로 요청해야 합니다.

운영환경URL : http://iniapi.inicis.com/api/v1/billing

참고로 PC웹표준, 모바일 빌키발급 모듈로 발급한 빌키는 모두 운영환경 거래로 진행됩니다.

3. billkey 발급 후 이니시스 서버간 동기화 처리되기 이전에 승인요청하여 billkey 가 확인되지 않는 경우 오류발생

모두 정상 세팅하였음에도 오류가 발생하는 경우, 당사 서버간 동기화 이슈로 발생된 오류일 수 있으므로 billkey 발급 후 5초 후에 재시도바랍니다.

[오류원인]

빌키발급 시 본인인증 여부가 MID 계약사항과 맞지 않게 요청한 경우 오류 발생

[조치방법]

1) 빌키발급 시 본인인증 여부는 MID 계약사항에 따라 상이하므로 영업담당자를 통해 본인인증 여부 확인필요

2) 빌키발급 시 생년월일, 비밀번호 인증을 진행하는 경우 authentification 필드 값을 “00” 으로 요청

생년월일, 비밀번호 인증을 진행하지 않는 경우 authentification 필드 값을 “01” 또는 “99” 로 요청

[오류원인]

일반적으로 모듈공개키 pgcert.pem 파일에 이상이 생겼을 경우 오류발생

 

[조치방법]

해당 pgcert.pem은 TX4, TX5버전별로 내용이 상이하기 때문에 덮어쓰기 된 경우 등으로 해당 오류가 발생될 수 있습니다.

 

혹 버전을 혼용하여 사용하실 경우는 해당 파일이 다른 버전과 겹치지 않도록 이용 부탁드립니다.

 

연동하신 모듈이 TX4 모듈인지 TX5 모듈인지 확인하신 후 해당하는 모듈공개키를 세팅바랍니다.

 

위와 같이 확인 후에도 동일오류 발생 시 ts@inicis.com 으로 log 파일 첨부하여 문의바랍니다.

(log 는 모듈이 설치된 경로(inipayhome) 내 /log 폴더에 일자별로 쌓입니다.)

[오류원인]

모바일 빌링모듈로 빌키 발급 시 해쉬데이터를 생성하여 데이터 검증을 진행하게 되나,

해당 해쉬데이터 생성값이 상이한 경우 오류 발생

 

[조치방법]

해쉬데이터는 INILite Key 를 이용하여 아래와 같이 SHA-256 해쉬데이터를 생성합니다.

 

Hashdata=SHA-256(mid + ordered + timestamp + INILite Key)

 

INILite Key 는 signkey 와 별도의 값이오니 하기 경로에서 확인되는 INILite Key 값으로 세팅하신 것이

맞는지 검토바랍니다.

 

 

[ INILite Key 확인경로 ]

가맹점관리자페이지 https://iniweb.inicis.com/ 에서 상점정보 > 계약정보 > 부가정보 > INILite Key 생성 갱신 조회

[오류원인]

휴대폰 빌링의 경우 인증 처리(빌키발급)시 자동으로 1회 승인까지 되는 구조이나,

자동승인 처리된 후 중복으로 승인요청 시 오류 발생

 

[조치방법]

현재 휴대폰 빌링의 경우 인증 처리시 자동으로 승인 되는 구조로 되어있습니다.

 

  1. 최초 빌키 발급 (이때 1회차 승인 과 함께 빌키 발생) + 승인
  2. 익월 해당 빌키로 결제시, 전월 일자 +- 5일 내로 동일금액을 올려야지만 통신사에서 승인처리

(SKT: +- 5일 , KT: 제한없음 , LG: +-7일)

 

즉, 1번에서는 인증 모듈을 통해 승인까지 1회 발생되며,

2번 모듈로는 익월 결제부터 빌키로 운용합니다.

 

통신사 정책에 제한되지 않았는지 체크바라며, KT 통신사 사용하신 경우라면 모듈 log 확인이 필요할 수 있으므로 log 첨부하여 ts@inicis.com 로 문의바랍니다.

(log 는 모듈이 설치된 홈디렉토리 내 /log 폴더에 일자별로 쌓입니다.)

모듈에 따른 빌키발급/빌링승인 1000원 미만 결제옵션은 아래와 같습니다.

 

 

  1. 빌키발급 시

웹표준 (asp,jsp,php 공통)

<input type=”hidden” name=”acceptmethod” value=”below1000″>

 

모바일 (asp,jsp,php 공통)

<input type=”hidden” name=merchantreserved value=”below1000=Y”>

 

 

  1. 실시간빌링요청 시 (TX4)

 

asp>

INIpay.SetField CLng(PInst), “merchantreserved3”, “below1000=1”

 

jsp>

data.setData(“merchantreserved3”,”below1000=1”);

 

php>

$inipay->m_merchantReserved3 = “below1000=1”;

$inipay->m_merchantreserved3 = “below1000=1”;

** 모듈 버전에 따라 대소문자 구분필요

[오류원인]

MID 값이 정확하지 않거나 signkey 값이 매칭되지 않을 경우 발생

 

[조치방법]

    1. 1. MID 입력 시 오타확인 및 소문자 구분확인

MID 는 10자리로 구성되어 있으며, 대소문자 구분하여 정확히 입력해야 합니다.

 

  1. 2. MID 와 매칭되는 signkey 확인

상점관리자 https://iniweb.inicis.com/ 에서 상점정보 > 계약정보 > 부가정보 > 웹결제signkey생성조회

 

결제요청페이지(INIStdPayRequest.xxx) 내 세팅한 MID 와 상점관리자페이지에서 확인한 signkey 가 정확히 세팅되어야 합니다.

[오류원인]

주문요청 시 가맹점에서 생성한 signature 값과 실제 input 값으로 넘기는 oid, price, timestamp 필드의 값과 대조하여 상이할 경우 오류 발생

[조치방법]

결제요청페이지 내 signature 생성 부분에서 확인되는 oid, price, timestamp 값과

(signature = “oid=” . $orderNumber . “&price=” . $price . “&timestamp=” . $timestamp; )

실제 input 값으로 넘기는 oid, price, timestamp 필드의 값이 일치하는지 확인이 필요합니다.

혹 결제창으로 넘기는 데이터내 값이 상이한 부분(금액이 변경되는 등)이 없는지 체크바랍니다.

[오류원인]

input 필드 값에 한글, 또는 인식 불가능한 특수문자가 포함될 경우에 발생

결제요청 페이지 도메인과 결제처리 페이지 도메인이 상이하거나, ‘closeUrl’ 과 ‘returnUrl’ 이 상이할 경우 발생

[조치방법]

1) input 필드 값에는 숫자만 입력이 가능하므로, 특수문자가 포함된 경우 제외바랍니다.

2) 결제요청 페이지 도메인과 결제처리 페이지 도메인, ‘closeUrl’ 과 ‘returnUrl’ 이 일치하는지 확인바랍니다.

결제요청 페이지 도메인이 http://www.inicis.com 일 경우, 결과받은 페이지를 세팅하는 closeUrl, returnUrl 부분도 동일하게  http://www.inicis.com 도메인으로 지정되어 있어야 합니다.

(ex : 한쪽 도메인에서 www 가 누락될 경우 해당 오류 발생될 수 있음)

[오류원인]

Key폴더 내 파일이 정상적이지 않거나 key 폴더를 찾을 수 없음

Key 폴더의 경로 오설정 또는 결과처리페이지 경로 오설정

 

[조치방법]

  1. 1. 모듈이 설치된 경로 내 /key 파일이 위치해 있는지 확인
  2. 2. php, jsp 의 경우 inipayhome 의 값이 모듈 경로로 설정된게 맞는지 (/key 폴더 상위 루트까지)

asp, asp.net 의 경우 INIpay50.dll 경로 내 /key 폴더가 위치하는지 확인

  1. 3. /key 폴더에 모든 권한이 주어져 있는지 (chmod 755) 확인
  2. 4. “admin” 필드는 “1111” 로 되어 있는지 확인 (상점관리자 패스워드와 무관함)

 

 

** TX 4.1, 및 TX 5.0 JAVA모듈의 예외사항

 

  1. a) JAVA버전의 경우 위 내용이 이상없음에도 불구하고, 9105 오류가 발생하는 경우

결제모듈에 포함된 INIcrypto_v3.1.7_signed.jar or ExecureCrypto_v1.0_jdk14 암호화 라이브러리의

설치오류를 의심할 수 있음

 

  1. b) INICrypto_v3.1.7_signed.jar or ExecureCrypto_v1.0_jdk14 라이브러리는 암호화 관련 라이브러리로

반드시 안내되는 위치에 옮겨야 함

 

  1. c) 웹서버 또는 WAS가 기동될 때 참조하는 루트 라이브러리 위치나 JDK 확장 라이브러리 디렉토리로

옮김.  예를 들면 $jdk_home/jre/lib/ext/ 디렉토리로 옮김. 또는,

tomcat의 경우는 $TOMCAT_HOME/shared/lib 디렉토리로 옮기고,

weblogic의 경우 $WEBLOGIC_JDK_HOME/jre/lib/ext 디렉토리에 옮김

또한 resin의 경우라면 $RESIN_HOME/lib/ 디렉토리에 옮겨야 함

 

* WEB-INF/lib 에 위치하여도 정상 동작한다.

 

 

※ 상점 개인키 로드 오류 코드별 원인

 

9103 : 상점 MID 이름으로 된 폴더가 없을 경우 오류발생

9301 : 상점 MID 이름으로 된 폴더가 없을 경우 오류발생

9105 : key 폴더 내 파일이 정상적이지 않거나, key 폴더를 찾을 수 없는 경우 오류발생

Key 폴더의 경로, 결과처리페이지 경로가 오설정 된 경우 오류발생

9109 : 키패스워드(admin) 오설정 된 경우 오류발생

(상점아이디로 된 키파일 내 readme.txt 에서 키패스워드 확인)