웹표준

모듈연동 FAQ

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

[오류원인]

결제요청 시 필수로 세팅되어야 할 파라미터가 누락된 경우 발생

[조치방법]

웹표준 모듈 매뉴얼(INIpayWebStandard_manual.pdf) 에서 필수파라미터 여부를 확인할 수 있습니다.

매뉴얼 내 “필수” 로 체크된 파라미터가 모두 세팅되어 있는지 확인바랍니다.

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

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

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

[오류원인]

상점 실 MID 를 테스트JS 로 결제요청한 경우 오류발생

[조치방법]

상점 리얼아이디로 결제할 때는 상용JS(운영서버) 로 요청하셔야 정상적으로 결제가 가능합니다.

결제요청페이지(INIStdPayRequest.xxx) 내 JS 부분을 확인하여주시기 바랍니다.

실 MID 적용 시 운영서버로 요청 ( js 부분 )

– 기존 js에서 “stg”만 제거

<!– 상용 JS(가맹점 MID 변경 시 주석 해제, 테스트용 JS 주석 처리 필수!) –>

<script language=”javascript” type=”text/javascript” src=“https://stdpay.inicis.com/stdjs/INIStdPay.js” charset=”UTF-8″></script>

[오류원인]

MID 와 매칭되지 않는 signkey 를 세팅한 경우 오류발생

[조치방법]

가맹점관리자페이지를 통해 MID 와 매칭되는 signkey 를 확인합니다.

가맹점관리자페이지 https://iniweb.inicis.com/ 에서 상점정보 > 계약정보 > 부가정보 > 웹결제signkey 생성조회

결제요청페이지(INIStdPayRequest.xxx) 내 세팅한 MID 와 상점관리자페이지에서 확인한 signkey 가 정확히 세팅되어야 합니다.

PHP 샘플 뒤 숫자는 PHP버전이며, 5가지 버전으로 샘플을 제공하고 있습니다.

INIStdweb_PHP_Sample_4.3.5  —> php 4.3.5 이상에서 사용 가능

INIStdweb_PHP_Sample_5.0.0  —> php 5.0.0 이상에서 사용 가능

INIStdweb_PHP_Sample_5.3.0  —> php 5.3.0 이상에서 사용 가능

INIStdweb_PHP_Sample_5.3.9  —> php 5.3.9 이상에서 사용 가능

INIStdweb_PHP_Sample_7.1.1  —> php 7.1.1 이상에서 사용 가능

예시)

가맹점 PHP 서버 5.2.4 일 때 5.3.0 / 5.3.9 버젼 샘플에서 사용되는 함수를 사용하지 못함

가맹점 PHP 서버 버전을 확인하여 버전에 맞는 샘플을 참고하여 연동바랍니다.

당사 웹표준 JSP 샘플은 두가지 버전으로 제공하고 있습니다.

jdk1.5 버전을 사용중이신 경우, INIStdweb_JAVA_Sample_v2.2_jdk1.5 샘플을 참고하시면 되며,

jdk1.5 이상의 버전을 사용중이신 경우, INIStdweb_JAVA_Sample_v2.2 샘플을 참고하여 연동하시면 됩니다.

[오류원인]

웹표준 모듈에서 인증결과 수신 후 승인요청 시 승인요청데이터 가 누락되거나 오입력된 경우 발생

[조치방법]

페이지 디버깅을 통해 authUrl 로 승인요청 시 필수요청 값이

정상세팅되어 전달되고 있는지 검토가 필요합니다.

샘플과 매뉴얼을 참고하시어 필수파라미터를 정상세팅하여 승인요청바랍니다.

>> INIStdPayReturn.jsp 샘플소스 내

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

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

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

[오류원인]

MID 값이 정확하지 않거나 signkey 값이 매칭되지 않을 경우 발생

 

[조치방법]

    1. 1. MID 입력 시 오타확인 및 소문자 구분확인

MID 는 10자리로 구성되어 있으며, 대소문자 구분하여 정확히 입력해야 합니다.

 

  1. 2. MID 와 매칭되는 signkey 확인

상점관리자 https://iniweb.inicis.com/ 에서 상점정보 > 계약정보 > 부가정보 > 웹결제signkey생성조회

 

결제요청페이지(INIStdPayRequest.xxx) 내 세팅한 MID 와 상점관리자페이지에서 확인한 signkey 가 정확히 세팅되어야 합니다.

[오류원인]

주문요청 시 가맹점에서 생성한 signature 값과 실제 input 값으로 넘기는 oid, price, timestamp 필드의 값과 대조하여 상이할 경우 오류 발생

[조치방법]

결제요청페이지 내 signature 생성 부분에서 확인되는 oid, price, timestamp 값과

(signature = “oid=” . $orderNumber . “&price=” . $price . “&timestamp=” . $timestamp; )

실제 input 값으로 넘기는 oid, price, timestamp 필드의 값이 일치하는지 확인이 필요합니다.

혹 결제창으로 넘기는 데이터내 값이 상이한 부분(금액이 변경되는 등)이 없는지 체크바랍니다.

[오류원인]

input 필드 값에 한글, 또는 인식 불가능한 특수문자가 포함될 경우에 발생

결제요청 페이지 도메인과 결제처리 페이지 도메인이 상이하거나, ‘closeUrl’ 과 ‘returnUrl’ 이 상이할 경우 발생

[조치방법]

1) input 필드 값에는 숫자만 입력이 가능하므로, 특수문자가 포함된 경우 제외바랍니다.

2) 결제요청 페이지 도메인과 결제처리 페이지 도메인, ‘closeUrl’ 과 ‘returnUrl’ 이 일치하는지 확인바랍니다.

결제요청 페이지 도메인이 http://www.inicis.com 일 경우, 결과받은 페이지를 세팅하는 closeUrl, returnUrl 부분도 동일하게  http://www.inicis.com 도메인으로 지정되어 있어야 합니다.

(ex : 한쪽 도메인에서 www 가 누락될 경우 해당 오류 발생될 수 있음)

[오류원인]

모바일 기기에서 PC웹표준 모듈을 호출한 경우 오류 발생

[조치방법]

이니시스 모듈은 PC모듈과 모바일 모듈이 구분되어 있습니다. (결제로직, 처리 파라미터 등이 모두 상이합니다.)

따라서 모바일 기기에서 결제를 진행하기 위해서는 별도로 모바일 모듈을 연동해주셔야 합니다.

** 모바일 모듈 연동가이드 자료확인

https://manual.inicis.com/mobile/