모듈연동 FAQ

hashdata 불일치 오류가 발생되는 경우, 요청 파라미터 내 세팅된 값과
hashdata 생성 시 PlainText (평문데이터) 값이 일치하는지 비교검토가 필요합니다.

hash 대상 파라미터는 각 API 별로 상이하며, 결제/승인 취소 API 를 통해 예시 드립니다.

ex) 결제/승인 취소 API
URL = https://iniapi.inicis.com/api/v1/refund

————————————————————————————————-
[요청파라미터] type = Refund
paymethod = Card
timestamp = 20191128121211
clientIp = 123.123.123.123
mid = INIpayTest
tid = StdpayCARDINIpayTest20191128121211123456
msg = 테스트
hashdata = b2dc4d4308d836a77187fa1f4ce8c540006a41e6a708a63aded363510c7d445600601c
9035825fe32f48fe1b7d2ea130f690a2895a41b6fa0a99c6c5f92d6d69
————————————————————————————————–

PlainText :
ItEQKi3rY7uvDS8lRefundCard20191128121211123.123.123.123INIpayTest
StdpayCARDINIpayTest20191128121211123456

SHA512 hash :
b2dc4d4308d836a77187fa1f4ce8c540006a41e6a708a63aded363510c7d445600601c
9035825fe32f48fe1b7d2ea130f690a2895a41b6fa0a99c6c5f92d6d69

위와 같이 정상 세팅했음에도 오류가 발생되는 경우,

mid 와 매칭되는 API KEY 값으로 hash 한 것이 맞는지 확인이 필요합니다.

가맹점관리자페이지https://iniweb.inicis.com/ 에서 상점정보 > 계약정보 > 부가정보 > INIAPI KEY 생성 갱신

오류원인 확인이 어려우신 경우 호출한 하기내용 첨부하여 ts@kggroup.co.kr 으로 문의바랍니다.

호출 URL :
요청파라미터 :
PlainText :

1) MID 의 INIAPI key 가 생성되었는지 확인

상점관리자 > 상점정보 > 계약정보 > 부가정보 > INIAPI key 생성 갱신

위 경로에서 확인되는 key 값으로 모듈에 세팅하였는지 확인바랍니다.

2) 실운영 MID 로 거래요청 시 운영계 URL 세팅여부 확인
운영계 URL = https://iniapi.inicis.com

실운영 MID 로는 개발계 URL 로 거래요청이 불가합니다.

위 내용으로 원인확인이 되지 않는 경우,

API URL 과 전체 파라미터 세팅값을 첨부하여 ts@kggroup.co.kr 로 문의바랍니다.

오류메세지와 같이 mid 값이 세팅되지 않았거나, 파라미터명이 오세팅 된 경우 발생되는 오류입니다.

또는 INIAPI 모듈에서 지원하지 않는 방식으로 전문전송 경우에도 발생될 수 있습니다. (JSON 방식 등)

INIAPI 의 경우 JSON 방식으로 데이터 전송이 불가하며,

key=value 형태의 파라미터를 POST로 요청해야합니다.

** PHP 언어로 연동 시 

PHP에서 POST요청을 curl로 처리할 때 배열의 파라미터가 제대로 전달되지 않는 경우에 mid is null 오류가 발생할 수 있습니다.

​

이 경우, http_build_query() 함수를 사용하여 URL 인코딩된 쿼리 문자열을 생성하신 후 재시도바랍니다.

ex) curl_setopt($ch, CURLOPT_POSTFIELDS, http_build_query($form_data)); 

1. 매뉴얼에 안내된 value 값 길이가 초과된 경우 오류발생

매뉴얼 우측에 안내된 파라미터 SIZE 를 초과하지 않도록 수정 후 재시도 바랍니다.

2, 특정 파라미터의 파싱이 잘못된 경우 오류발생

오류가 발생된 파라미터의 파싱이 정상적으로 처리되었는지 확인바랍니다.

위 내용으로 오류확인이 되지 않는 경우,

당사로 거래요청 시 세팅한 파라미터 값 전체를 하기 메일로 첨부하여 문의부탁드립니다.

기술지원 : ts@kggroup.co.kr

INIAPI 모듈에 안내된 필수 파라미터가 누락된 채 거래요청된 경우 발생되는 오류입니다.

연동중인 API 의 필수파라미터를 확인하여 세팅바랍니다.
( 볼드 처리된 파라미터가 필수입니다. )

ex) 계좌이체 부분환불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 로 변경하여 저장 후 파일 업로드