모듈연동 FAQ

모듈연동 FAQ

KG이니시스와 전자결제서비스에 대한 새로운 소식을 알려드립니다.
언제나 고객님께 가치 있는 소식을 전할 수 있도록 노력하겠습니다.

입금통보 노티를 수신받지 못한 사유에 대하여 확인 절차 안내드립니다.

[입금통보 노티수신 실패 사유 확인방법]

1. 채번된 가상계좌로 정상입금되었는지 확인

상점관리자 > 거래내역 > 가상계좌 > 입금결과조회

2. 입금결과조회 내역에서 정상조회되며, 입금TID (IniTechPG_) 가 생성된 경우

가상계좌 > 입금통보 재전송 메뉴에서 가상계좌 번호 조회

3. 거래일자 선택 후 해당 가상계좌 거래의 “입금통보결과” 확인

1) 상점으로부터 성공 응답받기 실패

가맹점 노티수신페이지에서 입금통보 노티 수신 후 “OK” 를 응답해야 하나,

OK 가 아닌 다른 응답을 한 경우 입니다.

가맹점 노티수신페이지에서 OK 응답을 하지 않거나 HTTP 500 에러 또는 404 에러 등으로 인해

정상 응답하지 못한 경우 등 10회까지 노티가 재전송 됩니다.

(OK 응답을 하지 않아도 가상계좌 거래건이 취소되지는 않습니다.)

노티수신페이지에서 정상응답하지 못한 사유는 가맹점 내부적으로 확인이 필요합니다.

** 가맹점 노티수신페이지 세팅

PC 가상계좌 –> 상점관리자 > 거래내역 > 가상계좌 > 입금통보방식 선택 > “URL 수신사용” 설정 및 URL 세팅

모바일 가상계좌 –> 모바일 결제요청 데이터 내 P_NOTI_URL 세팅

2) 통보전문구분오류

통보전문 방식이 선택되지 않은 경우 발생됩니다.

상점관리자 > 상점정보 > 계약정보 > 결제수단정보 > 가상계좌 내 통보전문 –> “URL 수신사용(일반)” 으로 설정

3) 상점서버정보 없음(IP, PORT, 전문구분)

통보전문 방식을 “수신모듈사용” 으로 설정 후 입금내역통보 IP/PORT 가 세팅되지 않은 경우 발생됩니다.

통보전문 방식을 “URL 수신사용” 으로 설정하시고 입금통보 URL 을 세팅바랍니다.

** PC 가상계좌 입금통보 수신페이지 샘플 및 가이드 확인 (상점관리자 내 세팅)

https://www.inicis.com/download_more# > 가상계좌수신모듈 탭

** 모바일 가상계좌 입금통보 수신페이지 가이드 확인 (모바일 결제요청 데이터 내 세팅)

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

가상계좌 입금통보 노티내역 및 가맹점응답에 대한 정보가 확인되지 않는 경우,

거래건TID 를 첨부하여 기술지원팀 메일 ts@inicis.com 으로 문의바랍니다.

데이터를 정확하게 입력하였음에도 아래와 같은 오류가 발생되면서 파일 업로드 저장이 되지 않는 오류 현상

– ID_MALL 1번째 데이터의 입력 갯수가 맞지 않습니다.

– 상점아이디가 올바르지 않습니다.

[오류원인]

파일 업로드 시 파일 인코드 형식으로 인해 문자열이 깨져 데이터가 정상인식되지 않음

[조치방법]

텍스트(txt) 파일 인코딩 형식을 UTF-8 –> ANSI 로 변경하여 저장 후 파일 업로드

[오류원인]

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

[조치방법]

웹표준 모듈 매뉴얼(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 가 정확히 세팅되어야 합니다.

할부개월수 선택은 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 를 통해 연결부탁드립니다.)

각 모듈에서 사용되는 IP 는 연동매뉴얼에  안내가 되어있으며,

주요  모듈 방화벽IP 는 아래와 같습니다.

– OUTBOUND 방화벽

 모듈  IP  PORT
 PC웹표준 118.129.210.86

183.109.71.30

118.129.210.47 (stg)

 443
 모바일 118.129.210.57

183.109.71.50

 443
 INIAPI 118.129.210.166

39.115.212.10

203.238.37.19 (개발)

 443
 TX5 (INIpay50) 203.238.37.3

39.115.212.10

 34049
 TX4 (INIpay41,45) 203.238.37.3

39.115.212.10

 9102

– INBOUND 방화벽

 모듈  IP  PORT
 PC 가상계좌입금통보 수신 203.238.37.3

203.238.37.15

203.238.37.16

203.238.37.25

39.115.212.9

가맹점포트(80/443)
 모바일 가상계좌입금통보 수신 118.129.210.25

183.109.71.153

203.238.37.15

가맹점포트(80/443)

참고로, 당사 (이니시스) 방화벽은 any 로 열려있어 결제요청에 따라 처리됩니다.

따라서 결제진행 시 당사에 가맹점 IP 를 별도로 등록하지 않으셔도 됩니다.

[오류원인]

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