[오류원인]
이미 취소된 거래를 다시 취소요청 시 오류발생
[조치방법]
해당 거래가 취소된 이력에 대하여 가맹점 내부적으로 우선 확인바랍니다.
가맹점관리자페이지 https://iniweb.inicis.com/ > 거래내역 에서 거래건 이력을 확인하실 수 있습니다.
취소이력 확인이 어려운 경우 ts@inicis.com 으로 거래건TID 를 첨부하여 문의바랍니다.
[오류원인]
모듈이 설치된 경로(inipayhome)에 key 폴더 내에 pgcert.pem 파일이 없거나,
권한이 없는 경우, 또는 다른 버전의 pgcert.pem파일을 사용할 경우 발생합니다.
* pgcert.pem (공개키) 은 모듈공개키로 TX4, TX5 등 버전별로 구분되어 적용됩니다.
[조치방법]
1. 처리페이지 내 inipayhome 필드에 세팅된 경로를 확인합니다.
2. inipayhome 경로에 /key 폴더를 확인합니다.
3. key 폴더 하위에 pgcert.pem 파일이 존재하는지 확인합니다.
4. 존재한다면 pgcert.pem 파일을 TX 버전에 맞는 파일로 교체한 후 재시도 합니다.
pgcert.pem 파일 검증이 필요하신 경우 이니시스 기술지원팀 ts@inicis.com 으로
오류가 발생된 거래건 log 파일과 key 폴더 압축본을 첨부하여 문의바랍니다.
log 는 가맹점 모듈이 설치된 경로 (inipayhome) 내 /log 폴더에 일자별로 쌓입니다.
[오류원인]
필수항목 [ paymethod ]는 플러그인에서 전달되는 값으로 채워지게 됨
결제요청페이지 -> 플러그인 -> 결제완료페이지 : 플러그인 동작 후에 정상적으로 값이 채워지게되나,
결제요청페이지 -> 결제완료페이지 : 플러그인이 동작하지 않고 호출될 경우 오류 발생
플러그인창에서 정상 진행 완료 이후에도 동일하게 발생하는 경우,
이니페이 마법사를 통해 사용자 PC내 플러그인이 정상적으로 설치되어 있지 않을 경우 발생
[조치방법]
스크립트 디버깅을 통해 문제 발생하는 부분 내용 확인 및 플러그인 호출하는makepaymessage() 함수의 정상작동 여부를 디버깅 해주시기 바랍니다.
브라우저 설정이 잘못 잡혀있는 경우, 고객PC의 문제가 대부분입니다.
당사 paymethod는 플러그인이 종료되면서 자동으로 채워주는 필드로 별도 제어를 하시면 안됩니다.
지불수단은 gopaymethod를 제어하시면 되며, 혹 paymethod를 제어하고 계시다면, 샘플과 동일하게
수정(원복) 후 재확인 부탁드립니다.
상기의 내용 확인 시에도 오류 발생시에는 오류 발생한 시점에 생성된 /%당사 모듈 설치경로%/log 폴더에 생성된 당사 모듈 로그를 ts@inicis.com 으로 전달바랍니다.
[오류원인]
가맹점 서버에서 요청하는 TX 모듈에서 이니시스 PG서버로 Socket OPEN OK / Send OK / RECV FAIL인 경우 발생
[조치방법]
RECV FAIL은 PG서버의 처리 결과를 가맹점 TX에서 수신하지 못한 케이스 이기 때문에 사유는 일시적
순단 등 포괄적인 사유로 발생됩니다.
이니시스 기술지원팀 ts@inicis.com 으로 모듈 로그를 첨부하여 확인요청 하시기 바랍니다.
log 는 가맹점 모듈이 설치된 경로(inipayhome) 내 /log 폴더에 일자별로 쌓입니다.
[오류원인]
로그폴더에 로그 파일을 쓰지 못하는 경우 발생
[조치방법]
(모듈이 설치된 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/