빌링

모듈연동 FAQ

모듈연동에 대한 궁금증을 해결해 보세요.

[오류원인]

빌링서비스 billkey 발급 요청 시 개인카드 / 법인카드 에 대한 정보가 상이할 경우 발생

(사업자번호 또는 주민등록번호/생년월일)

[조치방법]

빌링서비스 billkey 발급 요청 시 개인카드 / 법인카드 에 대한 정보가 상이할 경우 발생

(사업자번호 또는 주민등록번호/생년월일)

[조치방법]

사업자법인카드 로 빌링요청 시에는 사업자번호,

개인카드/ 개인법인카드 의 경우 생년월일로 인증요청 해주셔야 합니다.

인증진행중인 카드 종류 재확인 후, 해당 카드에 맞는 정보로 인증요청 바랍니다.

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

1단계 : 빌키발급 단계

2단계 : 빌링승인요청 단계

1. PC빌키발급 모듈 샘플 및 매뉴얼

** 모듈 연동자료 다운로드 경로

http://www.inicis.com/download_more  > INIpay(webStandard) 탭

( 홈페이지 ID : INIpayTest / PW : inicis~1111 )

webStandard 모듈 샘플 내 INIStdPayBill 페이지를 참고하시면 됩니다.

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

https://manual.inicis.com/iniapi/#billing-appl

** 모바일 빌키발급 모듈을 연동하고자 하는 경우 계약사항 확인이 필요하므로 영업담당자를 통해 요청해주시기 바랍니다.

(계약사항 확인 후 관련 연동매뉴얼을 전달받으실 수 있습니다.)

** 모바일 빌키발급 모듈로 빌키발급 후 빌링승인요청은 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 값으로 세팅하신 것이

맞는지 검토바랍니다.

 

 

[ 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 폴더에 일자별로 쌓입니다.)