고객센터

정기결제 빌링서비스의 경우 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” 로 요청

[오류원인]

일반적으로 모듈공개키 pgcert.pem 파일에 이상이 생겼을 경우 오류발생

[조치방법]

해당 pgcert.pem은 TX4, TX5버전별로 내용이 상이하기 때문에 덮어쓰기 된 경우 등으로 해당 오류가 발생될 수 있습니다.

혹 버전을 혼용하여 사용하실 경우는 해당 파일이 다른 버전과 겹치지 않도록 이용 부탁드립니다.

연동하신 모듈이 TX4 모듈인지 TX5 모듈인지 확인하신 후 해당하는 모듈공개키를 세팅바랍니다.

위와 같이 확인 후에도 동일오류 발생 시 ts@inicis.com 으로 log 파일 첨부하여 문의바랍니다.

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

[오류원인]

모바일 빌링모듈로 빌키 발급 시 해쉬데이터를 생성하여 데이터 검증을 진행하게 되나,

해당 해쉬데이터 생성값이 상이한 경우 오류 발생

[조치방법]

해쉬데이터는 INILite Key 를 이용하여 아래와 같이 SHA-256 해쉬데이터를 생성합니다.

Hashdata=SHA-256(mid + ordered + timestamp + INILite Key)

INILite Key 는 signkey 와 별도의 값이오니 하기 경로에서 확인되는 INILite Key 값으로 세팅하신 것이

맞는지 검토바랍니다.

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

[오류원인]

휴대폰 빌링의 경우 인증 처리(빌키발급)시 자동으로 1회 승인까지 되는 구조이나,

자동승인 처리된 후 중복으로 승인요청 시 오류 발생

[조치방법]

현재 휴대폰 빌링의 경우 인증 처리시 자동으로 승인 되는 구조로 되어있습니다.

1. 최초 빌키 발급 (이때 1회차 승인 과 함께 빌키 발생) + 승인
2. 익월 해당 빌키로 결제시, 전월 일자 +- 5일 내로 동일금액을 올려야지만 통신사에서 승인처리

(SKT: +- 5일 , KT: 제한없음 , LG: +-7일)

즉, 1번에서는 인증 모듈을 통해 승인까지 1회 발생되며,

2번 모듈로는 익월 결제부터 빌키로 운용합니다.

통신사 정책에 제한되지 않았는지 체크바라며, KT 통신사 사용하신 경우라면 모듈 log 확인이 필요할 수 있으므로 log 첨부하여 ts@inicis.com 로 문의바랍니다.

(log 는 모듈이 설치된 홈디렉토리 내 /log 폴더에 일자별로 쌓입니다.)

모듈에 따른 빌키발급/빌링승인 1000원 미만 결제옵션은 아래와 같습니다.

1. 빌키발급 시

웹표준 (asp,jsp,php 공통)

<input type=”hidden” name=”acceptmethod” value=”below1000″>

모바일 (asp,jsp,php 공통)

<input type=”hidden” name=merchantreserved value=”below1000=Y”>

2. 실시간빌링요청 시 (TX4)

asp>

INIpay.SetField CLng(PInst), “merchantreserved3”, “below1000=1”

jsp>

data.setData(“merchantreserved3”,”below1000=1”);

php>

$inipay->m_merchantReserved3 = “below1000=1”;

$inipay->m_merchantreserved3 = “below1000=1”;

** 모듈 버전에 따라 대소문자 구분필요