웹표준

모듈연동 FAQ

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

[오류원인]

웹표준 모듈에서 위와 같은 현상은 망취소 거래일 가능성이 높음

이니시스에서 가맹점 리턴페이지 로 승인결과 전달 후 가맹점에서 가맹점 측 통신 구간의 문제 또는 결과 처리(DB 처리 등) 구간 내 오류 발생 시 망취소 URL 로 망취소 요청

[조치방법]

망취소 된 사유는 가맹점 요청에 의한 취소이므로 가맹점 측에서 리턴페이지 확인이 필요합니다.

** 웹표준 모듈 결과페이지 내 처리구간 내 exception 이 발생하는 경우에 망취소를 요청 하도록 기본 구성이 되어 있습니다.

(INIStdpayReturn.xxx 샘플소스를 통해 확인가능)

ex) INIStdpayReturn.jsp 내 망취소 요청 샘플

추가로, 망취소 거래건의 경우 비정상 거래건으로 구분되어 가맹점관리자페이지 내에서는 조회되지 않습니다.

[오류원인]

최초 인증요청 시 금액과 승인요청시 요청 파라미터에 price 값을 비교하는 과정에서 금액이 불일치하여 발생된 오류

[조치방법]

인증요청 시 설정한 금액과 동일한 금액으로 승인요청 price 값이 세팅되도록 체크바랍니다.

샘플을 기준으로 INIStdPayRequest.xxx 에서 결제창 호출 시 세팅한 price 값과

INIStdPayReturn.xxx 에서 API 승인요청 전문 내 price 값이 일치하는지 확인하시면 됩니다.

[오류원인]

가맹점 측에서 동일 인증데이터를 중복으로 승인 요청 시 오류 발생

[조치방법]

  1. 인증결과로 승인요청 후 정상처리되어 승인결과를 전달
  2. 이후 인증결과로 재승인요청 하여 R201 오류 발생

가맹점 측 결과처리페이지(인증데이터 수신 후 승인 요청을 하는 페이지) 에서, 중복으로 승인 요청되고 있는 구간에 대하여 추가 체크가 필요

승인요청 시 인증결과로 수신한 authToken 값이 중복으로 요청되지 않도록 체크해주시면 됩니다.

** 일반적으로 해당 R201오류발생 시

재승인요청된 거래로 인해 이전 승인된 거래가 망취소 처리될 수 있습니다.

(1회 거래건 정상 승인 완료 -> 거래건 중복 승인 요청 -> 망취소 진행, 기존 1회 거래건과 동일 건이므로 기존건 망취소 됨)

[오류원인]

return페이지에서 인증결과 수신 후 승인요청을 위한 signature 값 생성 시 가맹점에서 생성한

signature 값과 실제 authUrl 로 전달하는 authToken, timestamp 값을 대조하여 상이할 경우 발생

 

[조치방법]

  1. 가맹점에서 signature 생성시 웹표준에서 내려준 정상적인 authToken 값으로 생성
  2. 승인 요청시 정상적으로 생성된 signature 값과 +가 유실된 authToken 값을 웹표준에서 수신
  3. 웹표준에서 검증시 정상적인 authToken으로 생성된 signature 와 +가 유실된 authToken 값으로 비교 >> 검증 오류 발생

혹 승인 요청 시 get방식으로 요청하지는 않는지 체크바랍니다.

(get방식 사용시 파라미터에서 +값이 유실될 수 있습니다.)

 

post 방식을 사용하시거나, 값이 유실되지 않도록 변환해서 요청바랍니다.

[오류원인]

사용자가 웹표준 결제창에서 “X” 버튼 등으로 취소한 경우 발생

(오류가 아닌 취소 결과에 대한 전달)

[조치방법]

웹표준 결제창 취소 시 closeUrl 을 호출하게 되나, closeUrl 이 설정되지 않았을 경우 취소 결과(V801)가 returnUrl 페이지로 전달됩니다.

closeUrl 은 기본적으로 설정하도록 가이드 상에 기재되어 있사오니 참고하여 세팅바랍니다.

연동가이드(샘플) 내 siteDomain 필드에서 도메인을 설정할 경우 returnUrl, closeUrl 이 일괄 적용되도록 구성되어 있습니다. (returnUrl 및 closeUrl 은 도메인이 일치해야 합니다.)

[오류원인]

가맹점 결제페이지에서 결제창 요청 가능시간(30분)이 초과 되었을 경우 발생

[조치방법]

주문요청페이지 내 장시간 대기 상태가 아니었음에도 위의 오류가 발생하는 경우, 사용자 pc내 시간 설정된 부분이 표준시로 설정이 되어 있는지 확인바랍니다.

추가적으로 가맹점 측 서버가 표준시로 설정된 부분이 맞는지, timestamp 값을 별도로 제어하고 있지는 않은지 체크바랍니다.