TX 

모듈연동 FAQ

모듈연동에 대한 궁금증을 해결해 보세요.

[오류원인]

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 에서 키패스워드 확인)

[오류원인]

암복호화 모듈 경로 오설정 또는 미설치된 경우 오류발생

 

[조치방법]

 

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내 플러그인이 정상적으로 설치되어 있지 않을 경우 발생

 

[조치방법]

  1. 모든 결제가 위의 오류로 발생한다면, 가맹점 측 결제페이지상의 플러그인 호출 관련 자바스크립트 오류일 경우가 많습니다.

스크립트 디버깅을 통해 문제 발생하는 부분 내용 확인 및 플러그인 호출하는makepaymessage() 함수의 정상작동 여부를 디버깅 해주시기 바랍니다.

 

  1. 특정 PC(고객)에서만 문제가 발생한다면, PC내에 플러그인이 정상적으로 설치되지 못하였거나

브라우저 설정이 잘못 잡혀있는 경우, 고객PC의 문제가 대부분입니다.

 

  1. http://www.inicis.com/wp-content/uploads/2013/11/INIpayWizard.exe (이니페이 마법사 실행)
  2. 브라우저 초기화 후 재시도

 

  1. paymethod를 제어하시고 있는지 여부 확인을 부탁드립니다.

 

당사 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 폴더에 일자별로 쌓입니다.

 

[오류원인]

로그폴더에 로그 파일을 쓰지 못하는 경우 발생

 

[조치방법]

  1. INIsecurestart.php 페이지 내 inipayhome 경로가 log 폴더가 존재하는 경로로 설정되어 있는지 확인

(모듈이 설치된 root 경로로 지정되었는지 체크, 해당 루트 내 log, key 폴더 위치해야 함)

 

  1. /%TX모듈 설치경로%/log 폴더 존재여부, 쓰기, 수정 권한 (755)  여부 확인

 

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 함수 실행 관련 버그로 전문에 홑따옴표가 포함되지 않도록 하셔야 합니다.