[오류원인] 모바일 결제요청 시 MID , 모바일 페이지 URL 형식이 잘못된 경우 오류발생 [조치방법] MID 등의 필수데이터가 정상 세팅되어 있는지 확인 모바일페이지 URL (P_NEXT_URL, P_NOTI_URL, P_RETURN_URL) 에 http/https 프로토콜 부분이 누락되지 않았는지 확인 ** 추가) 요청 전문 데이터가 올바르지 않은 경우 발생되는 오류코드 MX1003 : 금액이 누락된 경우 발생 MX1006 : 휴대폰 실물/컨텐츠 값이 잘못된 경우 발생 MX3001 : 숫자 입력 필드에 문자가 입력된 경우 발생
[오류원인]
모바일 기기에서 PC웹표준 모듈을 호출한 경우 오류 발생
[조치방법]
이니시스 모듈은 PC모듈과 모바일 모듈이 구분되어 있습니다. (결제로직, 처리 파라미터 등이 모두 상이합니다.)
따라서 모바일 기기에서 결제를 진행하기 위해서는 별도로 모바일 모듈을 연동해주셔야 합니다.
** 모바일 모듈 연동가이드 자료확인
[오류원인]
웹표준 모듈에서 위와 같은 현상은 망취소 거래일 가능성이 높음
이니시스에서 가맹점 리턴페이지 로 승인결과 전달 후 가맹점에서 가맹점 측 통신 구간의 문제 또는 결과 처리(DB 처리 등) 구간 내 오류 발생 시 망취소 URL 로 망취소 요청
[조치방법]
망취소 된 사유는 가맹점 요청에 의한 취소이므로 가맹점 측에서 리턴페이지 확인이 필요합니다.
** 웹표준 모듈 결과페이지 내 처리구간 내 exception 이 발생하는 경우에 망취소를 요청 하도록 기본 구성이 되어 있습니다.
(INIStdpayReturn.xxx 샘플소스를 통해 확인가능)
ex) INIStdpayReturn.jsp 내 망취소 요청 샘플
추가로, 망취소 거래건의 경우 비정상 거래건으로 구분되어 가맹점관리자페이지 내에서는 조회되지 않습니다.
[오류원인]
최초 인증요청 시 금액과 승인요청시 요청 파라미터에 price 값을 비교하는 과정에서 금액이 불일치하여 발생된 오류
[조치방법]
인증요청 시 설정한 금액과 동일한 금액으로 승인요청 price 값이 세팅되도록 체크바랍니다.
샘플을 기준으로 INIStdPayRequest.xxx 에서 결제창 호출 시 세팅한 price 값과
INIStdPayReturn.xxx 에서 API 승인요청 전문 내 price 값이 일치하는지 확인하시면 됩니다.
[오류원인]
가맹점 측에서 동일 인증데이터를 중복으로 승인 요청 시 오류 발생
[조치방법]
가맹점 측 결과처리페이지(인증데이터 수신 후 승인 요청을 하는 페이지) 에서, 중복으로 승인 요청되고 있는 구간에 대하여 추가 체크가 필요
승인요청 시 인증결과로 수신한 authToken 값이 중복으로 요청되지 않도록 체크해주시면 됩니다.
** 일반적으로 해당 R201오류발생 시
재승인요청된 거래로 인해 이전 승인된 거래가 망취소 처리될 수 있습니다.
(1회 거래건 정상 승인 완료 -> 거래건 중복 승인 요청 -> 망취소 진행, 기존 1회 거래건과 동일 건이므로 기존건 망취소 됨)
[오류원인]
return페이지에서 인증결과 수신 후 승인요청을 위한 signature 값 생성 시 가맹점에서 생성한
signature 값과 실제 authUrl 로 전달하는 authToken, timestamp 값을 대조하여 상이할 경우 발생
[조치방법]
혹 승인 요청 시 get방식으로 요청하지는 않는지 체크바랍니다.
(get방식 사용시 파라미터에서 +값이 유실될 수 있습니다.)
post 방식을 사용하시거나, 값이 유실되지 않도록 변환해서 요청바랍니다.
[오류원인]
사용자가 웹표준 결제창에서 “X” 버튼 등으로 취소한 경우 발생
(오류가 아닌 취소 결과에 대한 전달)
[조치방법]
웹표준 결제창 취소 시 closeUrl 을 호출하게 되나, closeUrl 이 설정되지 않았을 경우 취소 결과(V801)가 returnUrl 페이지로 전달됩니다.
closeUrl 은 기본적으로 설정하도록 가이드 상에 기재되어 있사오니 참고하여 세팅바랍니다.
연동가이드(샘플) 내 siteDomain 필드에서 도메인을 설정할 경우 returnUrl, closeUrl 이 일괄 적용되도록 구성되어 있습니다. (returnUrl 및 closeUrl 은 도메인이 일치해야 합니다.)
[오류원인]
가맹점 결제페이지에서 결제창 요청 가능시간(30분)이 초과 되었을 경우 발생
[조치방법]
주문요청페이지 내 장시간 대기 상태가 아니었음에도 위의 오류가 발생하는 경우, 사용자 pc내 시간 설정된 부분이 표준시로 설정이 되어 있는지 확인바랍니다.
추가적으로 가맹점 측 서버가 표준시로 설정된 부분이 맞는지, timestamp 값을 별도로 제어하고 있지는 않은지 체크바랍니다.
현금영수증 발급 방식에 따라 취소방법이 아래와 같이 구분됩니다. 1. 통합결제창 내 현금영수증 체크하여 발급 => 취소방법 : 가. INIAPI 취소로 승인거래건 취소 시 현금영수증도 자동 취소 나. INIAPI 부분취소로 거래건 부분취소 시 현금영수증 전체취소 후, 부분승인 금액만큼 재발행 다. 현금영수증만 취소를 희망하는 경우, 가맹점관리자페이지 내 거래내역 > 현금영수증 > 변경/취소 2. 현금영수증 단독 발급모듈 사용 => 취소방법 : 가. INIAPI 취소로 현금영수증 발급TID 를 취소요청 나. 부분취소는 불가하며, 전체 취소후 남은금액 만 다시 모듈을 통한 발행 3. 결제완료 후 가맹점관리자페이지 내 거래내역 > 현금영수증 > 건별요청 을 통해 발급
=> 취소방법 : 가. INIAPI 취소로 현금영수증 발급TID 를 취소요청 나. 부분취소는 불가하며, 전체 취소후 남은금액 만 다시 모듈을 통한 발행
휴대폰 결제의 경우, 계약사항에 따른 옵션 세팅이 필요합니다. 결제요청 시 계약사항에 맞는 옵션을 세팅하셨는지 여부 확인 부탁드립니다. (계약사항은 영업담당자를 통해 확인가능합니다.) - PC(웹표준)결제 컨텐츠 : <input name="acceptmethod" value=":HPP(1)”> 실물 : <input name="acceptmethod" value=":HPP(2)”> - 모바일결제 컨텐츠 : <input name="P_HPP_METHOD " value="1”> 실물 : <input name="P_HPP_METHOD " value="2”>