모듈연동 FAQ

[오류원인]

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


[조치방법]

PC(웹표준)결제 연동 웹매뉴얼 에서 필수파라미터 여부를 확인할 수 있습니다.

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


매뉴얼 및 샘플확인 : https://manual.inicis.com/stdpay/

[오류원인]

상점 실 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 가 정확히 세팅되어야 합니다.

할부개월수 선택은 5만원 이상 결제 시 가능하며,

결제요청페이지 소스 내 할부개월 수 옵션이 세팅되어 있어야 합니다.

<할부개월 수 옵션>

PC웹표준 모듈 (12개월까지 할부노출 시)

<input name=”quotabase” value=”1:2:3:4:5:6:7:8:9:10:11:12″ >

* default 일시불만 노출

모바일 모듈 (12개월까지 할부노출 시)

<input name=”P_QUOTABASE” value=”01:02:03:04:05:06:07:08:09:10:11:12″ >

* default 일시불~12개월 노출

참고로, nointerest(상점부담무이자) 필드는 상점부담무이자 계약이 된 경우에만 세팅하며, 계약하지 않은 경우 카드사 업종무이자 만 “무” 표시 됩니다.

(카드사 무이자할부 이벤트 확인 –> https://www.inicis.com > 소식/알림 에서 확인)

계약관련 내용은 영업담당자 문의바랍니다.

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

[오류원인]

빌링서비스 billkey 발급 요청 시 개인카드 / 법인카드 에 대한 정보가 상이할 경우 발생

(사업자번호 또는 주민등록번호/생년월일)

[조치방법]

빌링서비스 billkey 발급 요청 시 개인카드 / 법인카드 에 대한 정보가 상이할 경우 발생

(사업자번호 또는 주민등록번호/생년월일)

[조치방법]

사업자법인카드 로 빌링요청 시에는 사업자번호,

개인카드/ 개인법인카드 의 경우 생년월일로 인증요청 해주셔야 합니다.

인증진행중인 카드 종류 재확인 후, 해당 카드에 맞는 정보로 인증요청 바랍니다.

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 샘플을 참고하여 연동하시면 됩니다.

당사(이니시스)의 경우 PC모듈과 모바일 모듈이 구분되어 있으며,

따라서 입금통보 노티가 전송되는 경로와 파라미터가 상이합니다.

– PC 입금통보 노티수신페이지 세팅

가맹점관리자페이지 https://iniweb.inicis.com/ 에서 거래내역 > 가상계좌 > 입금통보방식선택

통보방식선택 : URL 수신사용

URL수신설정 : 입금통보URL 세팅

PC가상계좌 수신데이터 정보 및 관련 매뉴얼은 하기 경로에서 확인이 가능합니다.

http://www.inicis.com/download_more ( ID : INIpayTest / PW : inicis~1111 ) > 가상계좌 수신모듈 탭

– 모바일 입금통보 노티수신페이지 세팅

결제요청페이지 내 P_NOTI_URL 필드

모바일 가상계좌 수신데이터 정보 및 관련 매뉴얼은 하기 경로에서 확인이 가능합니다.

https://manual.inicis.com/mobile/ > 가상계좌입금통보

모바일 모듈의 경우 가상계좌 입금 시, “입금자명” 을 전달하는 필드는 존재하지 않습니다.

PC 모듈 가상계좌 거래 시 입금자명을 전달하는 필드 (nm_input) 가 존재하기는 하나 구매자명과 비교하지는 않습니다.  (구매자명과 입금자명이 상이해도 정상 입금처리)

가상계좌 거래는 가상계좌와 입금금액 이 채번정보와 일치할 경우 정상입금처리됩니다.