모듈연동 FAQ

모듈연동 FAQ

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

배송완료된 운송장번호로는 ‘배송등록’ 이 불가합니다.

따라서 ‘기타택배’ 로 배송등록 진행해주셔야 합니다.

기타택배 코드 : 9999

운송장번호 : 임의의 값

기타택배로 배송등록 시 등록일로부터 6일 후 자동구매결정 처리됩니다.

에스크로 거래의 경우, 배송등록 이전에는 거래취소가 가능하나, 배송등록 이후에는 배송완료 후 구매자가 구매확인 단계에서 ‘구매거절’ 요청하셔야 합니다.

다만 가상계좌 거래는 채번(가상계좌 요청) 거래 취소는 가능하나 입금 후에는 구매확인 단계까지 진행된 후 ‘구매거절’ 을 통해서만 환불처리가 가능합니다.

구매자가 구매거절 후 판매자가 ‘구매거절 확인’ 처리 시 거래취소 처리됩니다.

** ‘전단계취소’ 서비스를 이용하는 가맹점의 경우 모든 단계에서 취소가 가능하오니 관련 내용은 영업담당자를 통해 에스크로 전단계취소 서비스 이용여부 확인바랍니다.

에스크로 상태변경 노티URL 은 영업담당자를 통해 등록요청해주셔야 합니다.

(가맹점관리자페이지 내 에스크로 상태변경 노티URL을 등록하는 메뉴는 존재하지 않습니다.)

매뉴얼을 참고로 노티수신URL 페이지 구현하신 후 영업담당자를 통해 등록요청바랍니다.

매뉴얼 : https://manual.inicis.com/iniapi/escrow.html#noti

배송추적이 가능한 택배사의 경우 ‘배송완료’ 일자로부터 3일 후 자동구매결정 처리되며, 배송추적이 불가한 택배사(기타택배) 의 경우 ‘배송등록’ 일자로부터 6일 후 자동구매결정 처리됩니다.

정기결제 빌링서비스의 경우 2단계로 구분되어 있습니다.

1단계 : 빌키발급 단계
2단계 : 빌링승인요청 단계


1. 빌키발급 모듈 매뉴얼

PC 빌키발급 매뉴얼 : https://manual.inicis.com/stdpay/ > 추가기능 참고

좌측하단에서 샘플다운로드 후, INIStdPayBill 페이지를 참고하시면 됩니다.


모바일 빌키발급 매뉴얼 : https://manual.inicis.com/mobile/mo-bill.html


2. 빌링승인요청 모듈 매뉴얼

https://manual.inicis.com/iniapi/ > 빌링(정기과금) > 빌링승인


** 모바일 빌키발급 모듈로 빌키발급 후 빌링승인요청은 PC와 동일하게 INIAPI 로 요청하시면 됩니다.

[오류원인]

결제진행 시 사용한 카드가 해당 MID에 카드사 서브몰 등록이 되어 있지 않은 경우 발생되는 오류

 

[조치방법]

영업담당자를 통해 사용한 MID 의 카드사 서브몰 등록사항을 확인해야 합니다.

 

**  INIBillTst 테스트아이디의 경우는 국민카드 테스트 결제가 불가능합니다. (국민은행 정책)

INIBillTst 아이디로 테스트 진행하실 경우 국민카드를 제외한 다른 카드로 테스트진행바랍니다.

[오류원인]

– 없는 카드번호로 거래 요청한 경우 오류발생

– 카드 BIN 번호가 등록되어 있지 않은 경우 오류발생

[조치방법]

카드번호를 정확히 입력한 것이 맞는지 재확인바랍니다.

정상입력하였다면 결제 시 사용한 카드가 국내 카드사에서 발급한 카드가 맞는지 확인이 필요합니다.

(해외카드는 빌키 인증이 불가합니다.)

국내에서 발급한 카드가 맞는 경우 카드 prefix 번호확인 및 해당 카드정보(카드발급사 등)를 ts@inicis.com 로 확인요청 바랍니다.

[오류원인]

MID 계약사항에 승인요청 시 카드비밀번호, 생년월일 값을 입력하도록 설정되어 있으나, 해당 값이 누락되어 오류 발생

 

[조치방법]

1) 영업담당자를 통해 MID 계약사항 확인

2) 빌링승인요청 시 계약된 본인인증 정보를 포함하여 요청

 

정확한 확인이 어려운 경우 ts@inicis.com 로 모듈로그 첨부하여 확인요청바랍니다.

(log 는 모듈이 설치된 경로(inipayhome) 내 /log 폴더에 일자별로 쌓입니다.)

1. 빌링승인 요청 시 billkey 발급 당시 사용한 MID 와 다른 MID 로 승인요청하는 경우 오류발생

billkey 발급 당시 세팅한 MID 확인 후 승인요청 시에도 동일한 MID 를 세팅하였는지, billkey 값이 정상세팅된 것이 맞는지 확인바랍니다.

2. INIAPI 를 통한 빌링승인요청 시 운영계로 빌키발급 후 개발계로 빌링승인요청 하는 경우 오류발생

빌키발급 요청을 운영환경으로 진행한 경우, 빌링승인요청도 운영환경URL 로 요청해야 합니다.

운영환경URL : http://iniapi.inicis.com/api/v1/billing

참고로 PC웹표준, 모바일 빌키발급 모듈로 발급한 빌키는 모두 운영환경 거래로 진행됩니다.

3. billkey 발급 후 이니시스 서버간 동기화 처리되기 이전에 승인요청하여 billkey 가 확인되지 않는 경우 오류발생

모두 정상 세팅하였음에도 오류가 발생하는 경우, 당사 서버간 동기화 이슈로 발생된 오류일 수 있으므로 billkey 발급 후 5초 후에 재시도바랍니다.

[오류원인]

빌키발급 시 본인인증 여부가 MID 계약사항과 맞지 않게 요청한 경우 오류 발생

[조치방법]

1) 빌키발급 시 본인인증 여부는 MID 계약사항에 따라 상이하므로 영업담당자를 통해 본인인증 여부 확인필요

2) 빌키발급 시 생년월일, 비밀번호 인증을 진행하는 경우 authentification 필드 값을 “00” 으로 요청

생년월일, 비밀번호 인증을 진행하지 않는 경우 authentification 필드 값을 “01” 또는 “99” 로 요청