모듈연동 FAQ

자주 찾는 질문

KG이니시스 고객센터 입니다. 무엇을 도와드릴까요?

 

  1. 1. 운영계 거래건을 개발계로 취소요청할 경우 오류발생

 

PC웹표준 또는 모바일 모듈로 결제완료 후

INIAPI 거래취소 모듈로 취소요청 시 운영환경으로 취소요청 해야합니다.

 

취소요청URL 을 운영환경 (https://iniapi.inicis.com/api/v1/refund) 으로 세팅하여 재시도 바랍니다.

 

** PC웹표준 모듈에서 테스트JS 로 결제요청 하더라도 실 승인은 운영계로 처리되므로

취소요청 시 운영계로 요청해야만 정상처리됩니다.

 

 

  1. 2. 인증TID 취소요청할 경우 오류발생

 

모바일 모듈의 경우 인증TID 와 승인TID 로 TID 가 2번 전달됩니다.

 

인증TID –> INIMX_AUTH

승인TID –> INIMX_CARD / INIMX_ISP

 

인증TID 는 실결제에 대한 TID 가 아니므로 승인TID 로 취소요청 바랍니다.

 

 

  1. 3. 취소요청 TID 오타 또는 누락된 부분이 있을 경우 오류발생

 

취소요청 하는 거래건TID 가 올바른지 재확인 바랍니다.

 

 

위 내용으로 오류확인이 되지 않는 경우 거래건 TID 또는

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

 

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

 

 

1. 암호화 대상 필드의 값이 암호화되지 않은 상태로 거래요청 된 경우 오류발생

 

매뉴얼 내 파라미터 설명 부분에 “ENC” 표기가 있는 경우 AES암호화 전송해야 합니다.

ex) 가상계좌 환불 모듈 내 “환불계좌번호”

 

2. 암호화 시 사용한 KEY 또는 IV 값이 누락되거나 상이할 경우 오류발생

MID 와 매칭되는 KEY 값과 IV 값을 통해 암호화 한 것이 맞는지 확인합니다.

KEY 와 IV 는 상점관리자페이지(https://iniweb.inicis.com)에서 확인가능합니다.
–> 상점정보 > 계약정보 > 부가정보 > INIAPI key 생성 갱신

 

 

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

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

 

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

 

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로 요청해야합니다.

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

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

 

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

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

 

 

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

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

 

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

 

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

 

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

 

ex) 계좌이체 부분환불API 의 필수파라미터

 

 

 

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

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

 

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

크롬 브라우저

변경사항 

도메인이 서로 다른 사이트 간 이동을 POST로 하는 경우, 쿠키 획득 불가

(당사 결제서비스에서 가맹점 페이지로 전환되는 경우, 대부분 POST 사용)

예상 영향도

당사 결제(인증)을 진행하여 가맹점의 returnurl을 POST로 호출하는 경우

가맹점의 returnurl에서 “쿠키(eg, 로그인여부 확인 등) 등을 사용하고 있다면”

쿠키 획득이 불가하여 결제실패 등 영향도 有

 

  – 쿠키를 사용하는 가맹점 A.com 에서 당사 모바일/웹표준 결제를 사용하는 경우

  – 크롬 80버전으로 업데이트한 사용자가 가맹점 A.com 에서 결제를 진행할 때

  – 사용자가 결제(인증) 완료 후, POST 방식으로 가맹점 returnurl로 이동하는데,

  – 이때, 가맹점 페이지(returnurl)에서 쿠키 획득이 불가하여 오류가 발생할 수 있습니다.

 

 

* 각 결제서비스별 가맹점 응답페이지 URL필드는 아래와 같습니다.

  하기 파라미터는 가맹점마다 사용하는 서비스/방식 등이 상이하오니,

  현재 사용하는 필드 기준으로 확인해주세요.

 

  – 웹표준 : returnUrl, closeUrl, popupUrl

  – 모바일 : P_NEXT_URL, P_RETURN_URL, P_CANCEL_URL

  – WPAY 서비스 : returnUrl, cancelReturnUrl

  – 카드본인확인서비스 : Closeurl, Okurl

  – 모바일빌링 : returnurl

 

2. 가맹점 가이드

 대상 가맹점

쿠키를 사용하는 가맹점

(당사 결제서비스에서 가맹점 페이지로 전환되는 경우, 대부분 POST 사용)

 가맹점 변경사항

– 가맹점에서 쿠키 생성시 설정 변경 : SameSite=None; Secure

– 가맹점 응답 URL은 HTTPS로 처리되어야 합니다.

 가맹점 적용 일시

2020년 2월 3일까지 적용 필요

* 2020년 2월 4일 크롬 80 배포 예정으로 이전에 변경 적용 필요

  ( https://www.chromestatus.com/features/schedule )

 

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) 처리상태 가 “요청취소” 인 경우 입금불가

 

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

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