[오류원인]
웹표준 모듈에서 위와 같은 현상은 망취소 거래일 가능성이 높음
이니시스에서 가맹점 리턴페이지 로 승인결과 전달 후 가맹점에서 가맹점 측 통신 구간의 문제 또는 결과 처리(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 값을 별도로 제어하고 있지는 않은지 체크바랍니다.