모바일 

모듈연동 FAQ

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

[오류원인]

상점아이디(MID) 에 계약되지 않은 정보로 결제요청 한 경우 발생

[조치방법]

1. 영업담당자분을 통해 상점아아디(MID) 에 계약된 지불수단을 확인한 후

계약된 지불수단으로 결제요청합니다.

2. “휴대폰 결제” 계약이 되어 있으나 MX2003 오류가 발생된다면,

결제요청 시 P_HPP_METHOD 필드값을 확인바랍니다.

휴대폰 결제 계약사항 확인하시어 계약사항에 맞는 값으로 세팅하셔야 합니다.

컨텐츠 일 경우 : 1

실물일 경우 : 2

** 영업담당자를 모르실 경우 고객센터 1588-4954 를 통해 연결부탁드립니다.

기기 구분은 운영체제 (윈도우/안드로이드,IOS) 를 기준으로 하고 있으며,

테블릿은 스마트기기 브라우저이므로 모바일 모듈로 처리됩니다.

 

** 모듈 연동자료 다운로드 경로

http://www.inicis.com/download_more  > INIpay(Mobile) 탭

( 홈페이지 ID : INIpayTest / PW : inicis~1111 )

[오류원인]

숫자입력필드 (금액, 날짜 등) 에 숫자 외 한글이나 특수문자 등이 포함된 경우 오류가 발생됩니다.

[조치방법]

금액(P_AMT), 가상계좌 입금기한(P_VBANK_DT) 등의 파라미터 값 내 문자가 포함되었는지 확인합니다.

정상세팅되었음에도 오류가 발생하는 경우, 하기 결제요청 정보를 포함하여 ts@kggroup.co.kr (이니시스 기술지원) 으로 확인요청바랍니다.

** 결제요청정보
P_MID (상점아이디) :
P_OID (주문번호) :
P_AMT (거래금액) :
결제요청일자 :

[오류원인]

IOS 11.3 업데이트 이후 사파리 브라우저 보안 강화로 인해 모바일 인증결과 수신 URL(P_NEXT_URL) 프로토콜을 http 로 사용중인 가맹점에서 발생되는 오류현상

 

[조치방법]

결제 연동 URL (P_NEXT_URL)을 보안프로토콜(https) 로 사용해주시면 됩니다.

 

안드로이드, iOS 단말기에서 웹사이트에 대한 보안 인증을 강화하는 추세로 웹사이트에 대한 보안성

강화를 지속적으로 요구하고 있어, 해당 https 프로토콜을 사용하여 연동하실 것을 권장드립니다.

 

위 내용 체크 후에도 동일 이슈가 발생되는 경우

하기 결제요청 정보를 첨부하여 ts@inicis.com 로 메일 문의바랍니다.

 

– 해당 오류 발생 진행단계별 캡쳐화면 및 상세 내역

(정확히 어떠한 구간내 문제인지 확인 필요)

 

– 해당 거래건의 결제요청시 주문정보

상점아이디(P_MID) :

상점주문번호(P_OID) :

금액(P_AMT) :

주문일시 (결제 시도 일시 ) :

 

** 주문번호는 결제건 요청 당시 P_OID 값으로 확인이 가능합니다.

(주문번호가 없을 경우 거래건 추적이 어렵습니다.)

[오류원인]

INIMX_AUTH, INIMX_AISP 로 시작하는 TID 는 인증TID 이므로 취소가 불가합니다.

[조치방법]

모바일 신용카드 결제의 경우, P_NEXT_URL 로 인증TID 와 승인TID 로 TID 가 두 번 전달됩니다.

인증TID –> INIMX_AUTHINIpayTest20190603111111111111

또는  INIMX_AISPINIpayTest20190603111111111111

승인TID –> INIMX_CARDINIpayTest20190603111111111111

또는  INIMX_ISPINIpayTest20190603111111111111

승인TID 로 취소요청 시 정상 취소처리가 가능합니다.

[오류원인]

안드로이드 상점앱(웹뷰)으로 진행 시 타앱 호출 혹은 타앱에 대한 처리가 정상적으로 안되어 오류발생

[조치방법]

상점앱 내 타앱에 대한 처리될 수 있도록 앱 내 체크가 필요합니다.

– 앱내 처리 샘플

첨부된 AppCallSample.java 페이지 참고

AppCallSample.java

– 관련 매뉴얼

모바일웹 매뉴얼 33p “2. 앱 환경의 설치방법(안드로이드)” 부분 참고

[오류원인]

모바일 모듈로 결제요청 시 한글을 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 단으로 요청

  1. P_NEXT_URL 로 Socket의 Receive-Data로 출력된 승인결과 수신 (P_STATUS, P_RMESG1, P_TID )

인증성공 시 P_STATUS=00 은 인증성공에 대한 결과이며, 인증결과데이터로 승인요청까지 진행해야만 승인 후 실결제 처리됩니다.

인증결과로 전달된 P_REQ_URL로 승인요청까지 진행될 수 있도록 검토바랍니다.

관련내용은 INIpayMobile_WEB_manual_v.x.xx.pdf 매뉴얼 내

‘1-7. 승인요청 송신 및 승인처리결과 수신 (only 2 Transaction)’ 부분 하위내용 확인하시면 됩니다.

[오류원인]

결제진행 중 안드로이드 기기의 뒤로가기 버튼 사용 시 이전페이지를 호출하는데 필요한 데이터를 가져오지 못해 돌아가지 못하여 오류 발생

A->B->C 페이지 이동 시, B페이지를 호출 하기 위해서는 A->B로 정보를 넘겨주지만,

C->B 이동 시에는 B에서 필요한 정보를 가져올 수 없기 때문에 발생하는 현상입니다.

[조치방법]

안드로이드 기기의 뒤로가기 버튼은 사용이 불가하며, 처음부터 다시 결제를 진행하시도록 유도바랍니다.

가맹점 앱에서 뒤로가기에 대한 제어를 하고 있는 경우에도, 해당 제어로 인해, 결제에 문제가 발생할 소지가 있어 해당 동작을 하지 못하도록 가이드 하고 있습니다.

해당 가맹점 앱에서 뒤로가기에 대한 처리를 하고 있다면 해당 처리 동작하지 않도록 처리바랍니다.

[오류원인]

사용자가 계좌이체 결제 진행 중 금결원앱 호출 이후 금결원앱에서 취소를 하거나,

BankPay 앱에서 결제를 완료하지 않고 종료한 경우 발생하는 오류메시지

 

[조치방법]

인증 실패가 아닌, 고객이 금결원앱에서 인증을 정상완료하지 않은 경우이므로,

정상적인 플로우로 재결제하시도록 고객안내바랍니다.