모듈연동 FAQ

이니시스에서는 지급대행 서비스, 대사 서비스, 계좌성명조회 등 부가적인 서비스가 제공되고 있습니다. 


 * 부가서비스 안내 
가맹점관리자페이지 ( iniweb.inicis.com ) -> 부가서비스 -> 부가서비스 안내 


부가서비스를 이용하기 위해서는 영업담당자를 통해 추가 계약이 필요하오니,
영업담당자께 문의 부탁드립니다. 



부가서비스API 연동 관련 문의는 ts@kggroup.co.kr로 문의 부탁드리며,

API 요청 시 파라미터 오류가 발생되는 경우, 
하기 경로에서 파라미터 정상 유무 확인 가능합니다.


[부가서비스API 파라미터 확인]

크롬 브라우저 80버전에서 변경될(2월4일 출시 예정) 새로운 쿠키 정책(SameSite Cookie)에 따라

가맹점의 결제 불가 등의 영향도가 예상되어, 해당 가맹점은 2월 4일 이전까지 아래 사항 꼭 반영될 수 있도록 부탁드립니다.

1. 변경에 따른 결제 영향도

2. 가맹점 가이드

3. 참고사항

– 구글 공지 : https://blog.chromium.org/2019/10/developers-get-ready-for-new.html

– 참고 :

      https://web.dev/samesite-cookies-explained/

      https://www.chromestatus.com/feature/5088147346030592

      https://www.chromestatus.com/feature/5633521622188032

정확한 비밀번호를 입력하였음에도 비밀번호 오류가 발생하시는 경우
아래와 같이 브라우저 자동완성 기능을 해제하신 후 재시도바랍니다.


[오류원인]

인터넷 브라우저 내 비밀번호 자동완성기능 저장이 되어있을 시 해당 오류 발생


[조치방법]

브라우저 별 자동완성기능 및 비밀번호 자동저장 기능 내 등록된 데이터 삭제 방법


** 인터넷 익스플로러 Microsoft Internet explorer **

1) 도구 --> 인터넷 옵션




2) 내용 --> 자동완성 설정




3) 자동완성기록삭제 --> 양식데이터/암호 삭제






** 크롬브라우저 Google Chrome **


1) (우측상단) 클릭 --> 설정




2) 자동완성 탭 비밀번호




3) iniweb 검색 후 확인되는 저장된 비밀번호 모두 삭제 --> 자동로그인 기능 제거







** 엣지 브라우저 Microsoft Edge **


1) (우측상단) 클릭 --> 설정




2) 암호 및 자동완성 --> 암호저장 "끔" , 자동채우기 "끔"




3) 암호관리 --> 확인되는 데이터 모두 삭제

1. 가상계좌 번호 및 채번 금액과 일치하는지 확인

가상계좌 거래는 정확한 가상계좌 번호와 정확한 금액으로만 입금이 가능합니다.

2. 입금기한 확인

가상계좌 채번 요청 시 설정한 입금 기한 이내에만 입금이 가능합니다.

입금기한이 초과된 경우 가상계좌 입금이 불가하오니 입금을 원하시는 경우 다시 채번하셔야 합니다.

3. 가상계좌 채번거래 취소여부 확인

가상계좌 채번 거래 상태가 “요청취소” 인 경우 해당 가상계좌로 입금이 불가합니다.

** 가상계좌 채번 거래상태 확인방법

상점관리자 > 거래내역 > 가상계좌 > 입금결과조회 에서 “입금일자” –> “요청일자” 로 변경 후 거래조회

1) 처리상태 가 “미입금” 인 경우 정상입금 가능

2) 처리상태 가 “요청취소” 인 경우 입금불가

참고로 “요청취소” 상태는 가맹점에서 취소요청 모듈로 가상계좌 채번건을 취소한 경우입니다.

따라서 가상계좌 채번 거래가 취소된 사유는 가맹점에서 확인이 가능합니다.

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

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

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 로 변경하여 저장 후 파일 업로드

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

당사(이니시스)의 경우 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/ > 가상계좌입금통보

해당 오류의 경우, 브라우저 초기화를 통해 캐시삭제 시 정상처리 될 가능성이 높습니다.

상점관리자 접속하신 브라우저를 초기화 하신 후 재시도 부탁드립니다.

Internet Explorer 브라우저 초기화

1) IE 브라우저 도구 > 인터넷 옵션 > 일반 탭 > 임시인터넷 파일, 쿠키 등 삭제

2 ) IE 브라우저 도구 > 인터넷 옵션 > 고급 탭 > 고급 설정 복원, 원래대로 > 익스플로러 종료

3 ) IE 브라우저를 “관리자 권한으로 실행” 합니다

4 ) IE 브라우저 도구 > 인터넷 옵션 > 일반 탭 > 검색 기록 : 설정 > 임시 인터넷 파일 탭 > 웹 페이지를 열 때마다(E) 체크 확인

Chrome 브라우저 초기화

1) 크롬 브라우저에서 개발자도구(단축키 F12) 실행
2) “새로고침 버튼” 위에 마우스를 올리시고, 우 클릭 하신 후 [캐시 비우기 및 강력 새로고침] 진행

위 내용으로 조치되지 않는 경우,

원격 가능한 시간대와 연락처를 ts@inicis.com 으로 원격요청바랍니다.