빌링 

모듈연동 FAQ

모듈연동에 대한 궁금증을 해결해 보세요.
모바일 빌키발급 모듈을 연동하는 경우, 모바일에서도 billkey 를 발급받을 수 있습니다.
일반결제 모바일 모듈과는 요청URL 및 세팅파라미터가 상이하므로 모바일 빌키발급 모듈을 별도로 연동이 필요합니다.


연동매뉴얼은 하기 경로에서 확인가능합니다.

매뉴얼 : https://manual.inicis.com/mobile/mo-bill.html

모바일 빌키발급 모듈로 billkey 를 발급한 후, 해당 billkey 로 승인요청까지 진행해주셔야 실결제 됩니다.
(신용카드 빌링은 billkey만 발급할 경우 실결제되지 않습니다.)


빌링 승인요청 모듈은 하기 경로에서 확인가능합니다.

https://manual.inicis.com/iniapi/ > 빌링(정기과금) > 빌링승인
모바일 빌키발급 모듈을 연동하는 경우, 모바일에서도 billkey 를 발급받을 수 있습니다.
일반결제 모바일 모듈과는 요청URL 및 세팅파라미터가 상이하므로 모바일 빌키발급 모듈을 별도로 연동이 필요합니다.


연동매뉴얼은 하기 경로에서 확인가능합니다.

매뉴얼 : https://manual.inicis.com/mobile/mo-bill.html

모바일 빌키발급 모듈로 billkey 를 발급한 후, 해당 billkey 로 승인요청까지 진행해주셔야 실결제 됩니다.
(신용카드 빌링은 billkey만 발급할 경우 실결제되지 않습니다.)


빌링 승인요청 모듈은 하기 경로에서 확인가능합니다.

https://manual.inicis.com/iniapi/ > 빌링(정기과금) > 빌링승인
[신용카드 빌링]

1. PC 웹표준 빌링모듈, 모바일빌링 모듈을 통해 카드본인인증 --> Billkey 를 발급
2. Billkey 를 상점 DB에 저장
3. 과금 시 Billkey 로 실시간빌링요청 모듈 에서 승인요청
4. 승인완료 시 실 결제완료


[휴대폰 빌링] : 빌키발급 처리시 자동으로 승인 되는 구조로 되어있습니다. (통신사 정책)

1. PC 웹표준 빌링모듈, 모바일빌링 모듈을 통해 휴대폰 본인인증 --> Billkey 를 발급 + 1회차 승인
2. Billkey 를 상점 DB에 저장
3. 익월부터 과금 시, 전월 일자 +- 5일 내로 동일금액을 Billkey 로 실시간빌링요청 모듈 에서 승인요청
    (SKT: +- 5일 , KT: 제한없음 , LG: +-7일)
4. 승인완료 시 실 결제완료



각 모듈 확인하실 수 있는 경로 전달드립니다.

1. 빌키발급 모듈 매뉴얼

PC 빌키발급 매뉴얼 : https://manual.inicis.com/stdpay/ > 추가기능 참고
좌측하단에서 샘플다운로드 후, INIStdPayBill 페이지를 참고하시면 됩니다.

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


2. 빌링승인요청 모듈 매뉴얼 (PC, 모바일 공통)

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

[오류원인]

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

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

[조치방법]

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

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

[조치방법]

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

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

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

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