[오류원인] 모바일 모듈로 결제요청 시 한글을 utf-8 인코딩으로 전송한 경우 결제요청은 EUC-KR 로 정상요청하였으나, 가맹점 결과수신페이지에서 인코딩 문제가 발생된 경우 [조치방법] 당사 모바일 모듈은 EUC-KR 을 사용하므로 반드시 EUC-KR 인코딩으로 전송해야 합니다. <!--utf-8환경의 경우 accept-charset="euc-kr" 설정이 되셔야 한글이 깨지지 않습니다. ex) <form name="mobileweb_form" method="post" accept-charset="euc-kr"> 신용카드 등 2trs(동기 방식) 에서 인증/승인 결과를 utf8 로 수신하고자 하시는 경우, 결제요청 시 P_CHARSET=utf8 옵션설정 해주시면 됩니다. ex ) <input type=hidden name="P_CHARSET" value="utf8"> 다만, 1trs (비동기 방식) 의 경우 승인결과는 P_NOTI_URL 페이지를 호출하며 euc-kr 로만 승인결과가 전달됩니다. P_CHARSET=utf8 옵션 처리가 불가능하므로, euc-kr로 받을 수 있도록 처리가 필요합니다. 인코딩 문제는 서버 혹은 페이지 내 캐릭터셋, 인코딩 설정과 개발툴을 사용하는 경우 해당 환경설정 등의 여러 조건으로 인코딩 문제가 발생할 수 있으며, 이는 가맹점 자체적으로 확인이 필요합니다.
[오류원인] 모바일 모듈로 신용카드 결제진행 시 2트렌젝션 방식으로 진행되어 인증/승인 단계가 각각 존재하나, 인증결과만 수신 후 승인은 진행되지 않은 경우입니다. [조치방법] ** 모바일 2트렌젝션 결제로직 1. 결제요청페이지에서 결제창 호출하여 인증진행 2. P_NEXT_URL 로 인증결과 수신 (P_STATUS, P_RMESG1, P_TID, P_REQ_URL, P_NOTI , P_AMT ) 3. 인증결과로 받은 P_REQ_URL 로 P_MID 와 P_TID 를 전송하여 승인요청 이 때, Http-Socket 통신을 통해 Back-End 단으로 요청 4. P_NEXT_URL 로 Socket의 Receive-Data로 출력된 승인결과 수신 (P_STATUS, P_RMESG1, P_TID 등) 인증성공 시 P_STATUS=00 은 인증성공에 대한 결과이며, 인증결과데이터로 승인요청까지 진행해야만 승인 후 실결제 처리됩니다. 인증결과로 전달된 P_REQ_URL로 승인요청까지 진행될 수 있도록 검토바랍니다. 웹매뉴얼 내 3. 승인요청 구간 확인하시면 됩니다. 매뉴얼 : https://manual.inicis.com/mobile/
[오류원인]
결제진행 중 안드로이드 기기의 뒤로가기 버튼 사용 시 이전페이지를 호출하는데 필요한 데이터를 가져오지 못해 돌아가지 못하여 오류 발생
A->B->C 페이지 이동 시, B페이지를 호출 하기 위해서는 A->B로 정보를 넘겨주지만,
C->B 이동 시에는 B에서 필요한 정보를 가져올 수 없기 때문에 발생하는 현상입니다.
[조치방법]
안드로이드 기기의 뒤로가기 버튼은 사용이 불가하며, 처음부터 다시 결제를 진행하시도록 유도바랍니다.
가맹점 앱에서 뒤로가기에 대한 제어를 하고 있는 경우에도, 해당 제어로 인해, 결제에 문제가 발생할 소지가 있어 해당 동작을 하지 못하도록 가이드 하고 있습니다.
해당 가맹점 앱에서 뒤로가기에 대한 처리를 하고 있다면 해당 처리 동작하지 않도록 처리바랍니다.
[오류원인]
사용자가 계좌이체 결제 진행 중 금결원앱 호출 이후 금결원앱에서 취소를 하거나,
BankPay 앱에서 결제를 완료하지 않고 종료한 경우 발생하는 오류메시지
[조치방법]
인증 실패가 아닌, 고객이 금결원앱에서 인증을 정상완료하지 않은 경우이므로,
정상적인 플로우로 재결제하시도록 고객안내바랍니다.
[오류원인] 최초 주문요청 당시 P_MID 값과 승인요청 시 P_MID 값이 불일치하는 경우 오류발생 [조치방법] P_REQ_URL 로 승인요청 시 최초 주문요청 당시 세팅된 P_MID 값과 동일한 값으로 승인요청 되도록 세팅해주셔야 합니다. 최초 주문요청 시 세팅한 MID 값을 세팅하는 것이 어려우신 경우, 인증결과로 전달받으신 P_TID 에서 아래와 같이 변수처리를 통해 MID 값을 추출할 수 있습니다. 예시> $inimx->mid = substr($TID,'10','10')
[오류원인] 모바일 2trs 결제 시 인증결과 수신 후 승인요청 단계에서 발생되는 오류 P_REQ_URL 로 승인요청 시 P_TID 또는 P_MID 값이 누락된 경우 오류 발생 [조치방법] 이니시스 결제창 종료 후 P_NEXT_URL로 인증결과 수신 시 전달받은 P_REQ_URL 로 승인요청구간 확인이 필요합니다. (P_REQ_URL 승인요청 시 P_MID(주문요청MID), P_TID(인증결과TID) 값 세팅여부 확인) 누락된 값 확인이 어려운 경우, 결제요청정보 포함하여 ts@kggroup.co.kr 로 확인요청부탁드립니다. ** 결제요청정보 : P_MID(상점아이디), P_OID(주문번호), P_AMT(거래금액), 결제요청일시
[오류원인] 모바일 결제요청 시 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 값이 일치하는지 확인하시면 됩니다.