[오류원인]
로그폴더에 로그 파일을 쓰지 못하는 경우 발생
[조치방법]
(모듈이 설치된 root 경로로 지정되었는지 체크, 해당 루트 내 log, key 폴더 위치해야 함)
3. log폴더 rename 하신 후 log 폴더를 같은 경로로 생성하여 권한 부여 후 재시도
[오류원인]
상점 서버에서 이니시스 서버로 소켓연결 요청 시 실패될 경우 발생
[조치방법]
해당 모듈의 매뉴얼에 안내되어 있는 OUTBOUND 방화벽 허용여부 확인
방화벽 허용 되어 있음에도 오류가 발생하는 경우 telnet 접속 테스트 진행
** TX 5.0 일 경우 (INIpay50)
IP: 203.238.37.3 // 39.115.212.10
포트: 34049
프로토콜 : TCP
연결방향 : OUTBOUND
** TX 4.1 일 경우 (INIpay41)
IP: 203.238.37.3 // 39.115.212.10
포트: 9102
프로토콜 : TCP
연결방향 : OUTBOUND
[오류원인]
INIpay4 버전 결제모듈 작동을 위해 실행되는 *.phpexec 또는 *.javaexec 파일이, 서버내에서 실행되지
못할 경우 주로 발생
1) 결제라이브러리에서 실행파일의 경로를 찾지 못할 경우
– 결제페이지의 소스에는 “inipayHome” 이라는 모듈설치 디렉토리 경로가 있습니다.
이 경로가 모듈설치의 경로와 맞지 않을 경우 파일을 찾지 못하여 위 오류가 발생합니다.
2) 파일의 실행권한이 없을 경우
– exec 파일의 경우 아파치 또는 WAS 계정이 읽기/실행을 할 수 있어야 합니다.
– exec 파일은, OS내의 시스템함수 중 exec() 을 이용하여 작동합니다.
서버의 보안정책 문제로 이 함수를 실행하지 못할 경우에도 오류가 발생할 수 있습니다.
3) 파일이 손상되었을 경우
4) 설치파일과 OS 버전이 맞지 않을 경우
– exec 파일은 유닉스 계열 시스템 별로 각각 compile하여 배포됩니다.
따라서, OS의 종류와 설치파일의 버전이 맞지 않는 경우 오류가 발생할 수 있습니다.
– 윈도우 OS에서는 INIpay41 PHP 및 JSP 이용이 불가합니다.
[조치방법]
1) phpexec 또는 javaexec 위치를 결제페이지 소스상의 inipayhome 필드에 세팅
2) inipayhome/phpexec , inipayhome/javaexec 의 폴더 및 하위파일에 대해 chmod 755 * 설정
3) 서버 담당자를 통해 시스템 함수중 exec() 함수에 대한 제한설정 을 해제
4) 운용중인 서버OS 가 64bit 일 경우 -à ts@kggroup.co.kr 로 문의
해당 사항에 대해 특이 사항이 없는 경우 아래의 내용까지 추가적으로 확인 부탁드립니다.
결제요청 전문에 특정값( 상품명, 구매자명 등..) 에 ` (홑따옴표)가 포함되어 있다면,
해당 부분은 phpexec 함수 실행 관련 버그로 전문에 홑따옴표가 포함되지 않도록 하셔야 합니다.
[오류원인]
모듈의 공개키 ( pgcert.pem ) 로드가 정상적이지 않거나,
JSP 의 경우 암복호화 라이브러리가 정상 호출되지 않은 경우 발생
[조치방법]
다른버전의 pgcert.pem 파일이 사용될 경우 발생합니다.
맞지 않거나 정상적으로 호출하지 못했을 경우, 혹은 충돌이 발생했을 경우 해당 오류가 발생될 수
있습니다.
해당하는 라이브러리는 암호화 관련 라이브러리로 반드시 안내되는 위치에 있어야 합니다.
예를 들어, $jdk_home/jre/lib/ext/ 디렉토리에 위치하거나,
(JDK 라이브러리에 위치시키는 것을 권장드립니다.)
또는,
tomcat의 경우 $TOMCAT_HOME/shared/lib 디렉토리로,
weblogic의 경우 $WEBLOGIC_JDK_HOME/jre/lib/ext 디렉토리,
resin의 경우 $RESIN_HOME/lib/ 디렉토리로 옮깁니다.
* WEB-INF/lib 에 위치하여도 정상 동작합니다.
웹서버 또는 WAS가 기동될 때 반드시 한 번만 호출되도록 구성이 필요합니다.
[오류원인]
키파일 값이 잘못됨
모듈 공개키 파일이 사용모듈 버전과 맞지 않을 경우 발생
[조치방법]
(다른버전의 pgcert.pem 파일이 사용될 경우 발생될 수 있음)
기기 구분은 운영체제 (윈도우/안드로이드,IOS) 를 기준으로 하고 있으며, 테블릿은 스마트기기 브라우저이므로 모바일 모듈로 처리됩니다. 모바일 연동매뉴얼 : https://manual.inicis.com/mobile/
[오류원인]
숫자입력필드 (금액, 날짜 등) 에 숫자 외 한글이나 특수문자 등이 포함된 경우 오류가 발생됩니다.
[조치방법]
금액(P_AMT), 가상계좌 입금기한(P_VBANK_DT) 등의 파라미터 값 내 문자가 포함되었는지 확인합니다.
정상세팅되었음에도 오류가 발생하는 경우, 하기 결제요청 정보를 포함하여 ts@kggroup.co.kr (이니시스 기술지원) 으로 확인요청바랍니다.
** 결제요청정보
P_MID (상점아이디) :
P_OID (주문번호) :
P_AMT (거래금액) :
결제요청일자 :
[오류원인]
IOS 11.3 업데이트 이후 사파리 브라우저 보안 강화로 인해 모바일 인증결과 수신 URL(P_NEXT_URL) 프로토콜을 http 로 사용중인 가맹점에서 발생되는 오류현상
[조치방법]
결제 연동 URL (P_NEXT_URL)을 보안프로토콜(https) 로 사용해주시면 됩니다.
안드로이드, iOS 단말기에서 웹사이트에 대한 보안 인증을 강화하는 추세로 웹사이트에 대한 보안성
강화를 지속적으로 요구하고 있어, 해당 https 프로토콜을 사용하여 연동하실 것을 권장드립니다.
위 내용 체크 후에도 동일 이슈가 발생되는 경우
하기 결제요청 정보를 첨부하여 ts@inicis.com 로 메일 문의바랍니다.
– 해당 오류 발생 진행단계별 캡쳐화면 및 상세 내역
(정확히 어떠한 구간내 문제인지 확인 필요)
– 해당 거래건의 결제요청시 주문정보
상점아이디(P_MID) :
상점주문번호(P_OID) :
금액(P_AMT) :
주문일시 (결제 시도 일시 ) :
** 주문번호는 결제건 요청 당시 P_OID 값으로 확인이 가능합니다.
(주문번호가 없을 경우 거래건 추적이 어렵습니다.)
[오류원인]
INIMX_AUTH, INIMX_AISP 로 시작하는 TID 는 인증TID 이므로 취소가 불가합니다.
[조치방법]
모바일 신용카드 결제의 경우, P_NEXT_URL 로 인증TID 와 승인TID 로 TID 가 두 번 전달됩니다.
인증TID --> INIMX_AUTHINIpayTest20190603111111111111
--> INIMX_AISPINIpayTest20190603111111111111
승인TID --> INIMX_CARDINIpayTest20190603111111111111
--> INIMX_ISPINIpayTest20190603111111111111
승인TID 로 취소요청 시 정상 취소처리가 가능합니다.
[오류원인]
안드로이드 상점앱(웹뷰)으로 진행 시 타앱 호출 혹은 타앱에 대한 처리가 정상적으로 안되어 오류발생
[조치방법]
상점앱 내 타앱에 대한 처리될 수 있도록 앱 내 체크가 필요합니다.
- 앱내 처리 샘플
첨부된 AppCallSample.java 페이지 참고
AppCallSample.java
- 관련 매뉴얼
모바일 웹매뉴얼 https://manual.inicis.com/mobile/ "앱 연동 시 참고문서" 참고