[오류원인]
Key폴더 내 파일이 정상적이지 않거나 key 폴더를 찾을 수 없음
Key 폴더의 경로 오설정 또는 결과처리페이지 경로 오설정
[조치방법]
asp, asp.net 의 경우 INIpay50.dll 경로 내 /key 폴더가 위치하는지 확인
** TX 4.1, 및 TX 5.0 JAVA모듈의 예외사항
결제모듈에 포함된 INIcrypto_v3.1.7_signed.jar or ExecureCrypto_v1.0_jdk14 암호화 라이브러리의
설치오류를 의심할 수 있음
반드시 안내되는 위치에 옮겨야 함
옮김. 예를 들면 $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 에서 키패스워드 확인)
[오류원인]
암복호화 모듈 경로 오설정 또는 미설치된 경우 오류발생
[조치방법]
1. ExecureCrypto_v1.0_jdk14 의 암호화 모듈 서버에 세팅
(해당 프로젝트 WEB-INF 혹은 루트 경로에 넣으시면 됩니다.)
※ 해당 라이브러리가 중복 호출될 경우 충돌로 인해 해당 오류가 발생될 수 있습니다.
2. ExecureCrypto_v1.0_jdk14 의 암호화 모듈 사용 선언
inipay.SetField(“crypto”, “execure”); // Extrus 암호화모듈 사용(고정)
[오류원인]
원거래 금액(혹은 최종 부분취소 이후 남은 금액 ) – 취소 금액 = 남은 금액
부분취소 요청 시 취소금액과 남은 금액이 위 산식에 맞지 않게 설정된 경우 오류발생
[조치방법]
원 거래 금액 재확인 후, 아래와 같이 필드세팅바랍니다.
(PRICE (취소금액) + CONFIRM_PRICE (남은 금액) = 원 거래금액)
참고로, 부분취소를 여러 차례 진행하는 경우, 부분취소 후 남아 있는 총 금액을 확인하여 계산하시면 됩니다.
** 여러 차례 부분취소하는 경우에도 부분취소 요청 시 원거래TID 로 요청합니다.
다만 금액은 이전 부분취소 처리 후 남은 금액으로 총 금액을 계산합니다.
[오류원인]
이미 취소된 거래를 다시 취소요청 시 오류발생
[조치방법]
해당 거래가 취소된 이력에 대하여 가맹점 내부적으로 우선 확인바랍니다.
가맹점관리자페이지 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 함수 실행 관련 버그로 전문에 홑따옴표가 포함되지 않도록 하셔야 합니다.