[오류원인] MID 값이 정확하지 않거나 signkey 값이 매칭되지 않을 경우 발생 [조치방법] 1. MID 입력 시 오타확인 및 소문자 구분확인
MID 는 10자리로 구성되어 있으며, 대소문자 구분하여 정확히 입력해야 합니다. 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 . “×tamp=” . $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 폴더의 경로 오설정 또는 결과처리페이지 경로 오설정
[조치방법]
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 폴더에 일자별로 쌓입니다.