실시간 빌링서비스 트랜잭션 정의 - 이니시스 · 실시간 빌링서비스 트랜잭션 정의 Pub. Date: 2018. 10 Page 5 2. 실시간 빌링 서비스의 조건 1

실시간 빌링서비스 트랜잭션 정의

㈜KG 이니시스


Page ii Pub. Date: 2018. 10

Copyright © 2008 INICIS Co, Ltd. All rights reserved.

본 문서와 정보는 (주)이니시스의 재산입니다. 또한, 모든 정보는 (주)이니시스 소유 정보이

며,(주)이니시스의 사전 동의 없이 본 문서의 어떤 정보도 열람, 복사, 유용, 배포 또는 타인과

공유되어서는 안됩니다. 본 문서의 정보는 변경될 수 있으며 변경 시, 본 문서는 수정될 것입

니다. 본 문서의 내용에 관한 어떠한 의견이라도 귀하의 프로젝트 또는 사업 담당자에게 전달

하여 주십시오.

Title: INIbill_windows.doc

Author: 플랫폼 개발팀

Version: 0.1.2

작성일 수정 내용 작성자 문서 버전

2008-02-28 최초 작성 백승길 V 0.0.1

2010-02-08 문서 포맷 변경 최웅식 V 0.0.2

2010-11-10 하나 SK 카드사 코드 추가 최웅식 V 0.0.3

2013-03-12 빌링 가능 카드 변경 장현찬 V 0.0.4

2016-04-12 실시간 신용카드 빌링 옵션 추가

- acceptmethod : BILLAUTH 오수민 V 0.0.5

2016-08-23 CI 및 사명 변경, 빌링 본인인증값 수정 장현찬 V 0.0.6

2016-09-08 빌링 휴대폰 제휴사 변경 관련하여 옵션 수정 이윤선 V 0.0.7

2016-10-27 아웃바운드 IP 추가 최정 V 0.0.8

2016-12-29 부가세/면세 필드 추가 정현성 v 0.0.9

2017-01-04 이통사 정보 필드 응답값 변경 김재호 v 0.1.0

2017-08-25 카카오뱅크 카드사코드 유경선 v 0.1.1

2018-10-30 목동센터 폐쇄에 따른 아웃바운드 IP 삭제 정현성 v 0.1.2

실시간 빌링서비스 트랜잭션 정의 목 차

Pub. Date: 2018. 10 Page III

목 차

1. 실시간 빌링 서비스 개요 ....................................................................................... 4

2. 실시간 빌링 서비스의 조건 ................................................................................... 5

3. 메시지 전달 방식 ................................................................................................... 6

3.1 방화벽 문제 .................................................................................................................. 6

4. 처리 절차 ............................................................................................................... 7

5. 빌링 방법 - 실시간 빌링 ....................................................................................... 8

5.1 신용카드 빌링 ............................................................................................................... 8

5.1.1 실시간 빌링을 위한 신용카드의 유효성 확인 및 등록 단계 ...................... 8

5.1.2 빌링 요청 단계 ............................................................................................. 11

5.2 핸드폰 빌링 ................................................................................................................ 13

5.2.1 실시간 휴대폰 빌링을 위한 휴대폰의 유효성 확인 및 등록 단계 ........... 13

5.2.2 빌링 요청 단계 ............................................................................................ 16

6. 코드표 ................................................................................................................... 18

6.1 카드사 코드 ................................................................................................................ 18


Page 4 Pub. Date: 2018. 10

1. 실시간 빌링 서비스 개요

상점 고객이 회원제 서비스 또는 월정액 과금 상품 구매요청 단계에서,

이니시스가 제공하는 본인인증 서비스 수행후 전달받은 KEY 를 이용하여, 추후

해당 고객에 대한 과금 필요시 해당 KEY 를 이니시스로 전송하여 실시간으로

과금하는 서비스.


Pub. Date: 2018. 10 Page 5

2. 실시간 빌링 서비스의 조건

1. 반드시 실시간 빌링서비스 업체로 당사에 등록.

2. 현재 실시간 빌링 가능 카드.(현재 2013 년 3 월)

- 외한, 롯데, 삼성, 신한, 현대, 국민, 비씨, NH, 하나 SK, (씨티)

- 당사는 씨티카드와 직접적인 가맹점 계약은 되어 있지 않음.

3. 신용카드 본인인증 트랜잭션 처리 후 전달 받은 BillingKey 을 실시간 빌링 요청시

전송해야만 빌링 가능.



3. 메시지 전달 방식

이니시스가 제공하는 지불시스템을 통해 상점의 지불서버와 이니시스 PG 간

TCP/IP 소켓 통신을 통해 메시지를 송수신 받아 처리한다.

3.1 방화벽 문제

연결대상 : 203.238.37.3, 39.115.212.10

프로토콜 : TCP

포트번호 : 9400

연결방향 : OUTBOUND



4. 처리 절차

1. 상점 고객이 본인인증 트랜잭션을 통해 본인인증 절차를 거쳐 BillingKey 를 받아

상점 DB 에 보관한다. (BillingKey : Billing 트랜잭션을 위한 기본 key ( 40 자리))

2. 빌링 작업시 빌링요청 트랜잭션을 통하여 BillingKey 를 전송하여 승인을 받는다.



5. 빌링 방법 - 실시간 빌링

5.1 신용카드 빌링

5.1.1 실시간 빌링을 위한 신용카드의 유효성 확인 및 등록 단계

본인인증 API : AUTH

본인 인증 입력 페이지 : INIauth_bill.html

본인 인증 처리, 결과 페이지 : INIauth_bill.php

요청 필드 예시 설명 필수여부 길이(Max)

mid INIBillTst 이니시스 상점 아이디 Yes Fixed

admin 1111 상점 키 패스워드 Yes Fixed

buyername 홍길동 구매자 명 Yes 30

encrypted 암호화 데이터

플러그인에서 사용하는 예약필드 Yes N/A

sessionkey 암호화 데이터 플러그인에서 사용하는 예약필드 Yes N/A

goodname 축구공 상품명 No 80

url http://www.xx.kr 상점url (내부 참고용) Yes 100

price 1000 상품 금액 No Fixed

ini_offer_period 20140101 부터 20140131 까지 제공한다면

2014010120140131 제공기간 No N/A



merchantreserved3 예비 필드 No

N/A

결과 필드 예시 설명 길이(Max)

resultcode “00” : 성공

이외 실패

2

resultmsg

Success message :

[신용카드|본인인증이 성공하였습니다.] Failure message :

[1223][인증실패|유효기간 오류]

결과 메시지 200

cardcode 02 카드코드 2

tid INIpayBillINIBillTst20091216110906437565 거래번호 40

billkey 39ded0b6306b96b8b3166d02de7ffdd8639c5b24 BILL KEY. 40

acceptmethod

BILLAUTH

해당 값 변경 불가 (필수)

개인/법인 카드 구분 (선택)

- 개인 : PERCARD

- 법인 : COCARD

nohpp

01112458745 모바일 인증 요청일경우만 반환 11

제공기간(ini_offer_period) 상세 설정 안내

- 일자 기준으로 제공기간 표시

예) 20140101 부터 20140131 까지 제공한다면

<input type=hidden name=ini_offer_period value="2014010120140131">

- 일자+시간까지 포함해서 제공기간 표시

예) 20140101 10:00 부터 20140131 23:00 까지 제공한다면

<input type=hidden name=ini_offer_period value="201401011000201401312300">



개인/법인 카드 구분

- acceptmethod value 에 BILLAUTH 값은 필수

- 카드 구분을 원할 시, BILLAUTH 값 뒤에 :을 구분자로 하여 옵션 셋팅

개인 : PERCARD / 법인 : COCARD 옵션 셋팅

예) 개인 카드 시

<input type=”hidden” name=”acceptmethod” value=”BILLAUTH:PERCARD”>

예) 법인 카드 시

<input type=”hidden” name=”acceptmethod” value=”BILLAUTH:COCARD”>



5.1.2 빌링 요청 단계

실시간 빌링 API : ReqBill

실시간 빌링 입력 페이지 : INIreqrealbill.html

실시간 빌링 처리, 결과 페이지 : INIreqrealbill.asp


mid INIBillTst 상점 아이디 Yes Fixed

admin 1111 상점 개인키 패스워드 Yes Fixed

debug true/false true: 상세한 로그를 남김 Yes Fixed


paymethod “Card” or “HPP” 걸제수단 Yes Fixed

buyername 홍길동 구매자명 NO 30

buyertel 0105584878 구매자 연락처 NO 20

buyeremail [email protected] 구매자 이메일 NO 60

goodname 축구공 상품명 NO 80

cardquota “00”

할부개월

00:일시불

02:2개월 . . .

12:12개월

yes Fixed

price 1000 상품가격 yes Fixed

currency “WON” / “USD” 화페단위 KR : WON US : USD

yes Fixed

oid 384d91ld94 상점 주문번호 NO 40

quotainterest “0” / “1” 무이자 유무 Yes Fixed



“0” : 일반할부

“1” : 무이자할부

billkey Billing Key Yes Fixed

merchantreserved1 예비필드1 Tax : 부가세 / TaxFree : 면세 (예 Tax=100&TaxFree=900) NO N/A

merchantreserved2 예비필드2 NO N/A


authentification “00” / “01”

00 :인증 ( 공인인증서로 인증받지 않은 경우, 비밀번호+주민번호

앞 6자리 필요)

01: 세미인증 ( 공인인증로 인증받은 빌키를 이용하는 경우, 비밀번

호+주민번호 앞 6자리 필요없음.)

Yes 2

regnumber 주민 번호 앞 6 자리 및 사업자 번호 입력 authentification 이 “00”

일경우 NO

cardpass 02 키드 비밀번호번(앞 2 자리) authentification 이 “00” 일경우 NO


resultcode 00 : 성공

01 : 실패 결과 코드 2

resultmsg

Success message :

[신용카드|빌링이 정상적으로 이루어

졌습니다.] Fail message :

[1294][ 신용카드 |기간 만료 카드]


tid INIpayBillINIBillTst20091216142119937565

거래 번호 40

authcode 신용카드 승인번호 8

pgauthdate 20091216 승인 날짜(yyyyMMdd) 8

pgauthtime 210212 승인 시간(hhmmss) 6

cardnumber 49062540****2545 카드번호 16



5.2 핸드폰 빌링

5.2.1 실시간 휴대폰 빌링을 위한 휴대폰의 유효성 확인 및 등록 단계

본인인증 API : AUTH_BILL

본인 인증 입력 페이지 : INIauthbill_hpp.html

본인 인증 처리, 결과 페이지 : INIauthbill_hpp.asp


mid INIBillTst 이니시스 상점 아이디 Yes Fixed

admin 1111 상점 키 패스워드 Yes Fixed

buyername 홍길동 구매자 명 Yes 30

encrypted 암호화 데이터

플러그인에서 사용하는 예약필드 Yes N/A

sessionkey 암호화 데이터 플러그인에서 사용하는 예약필드 Yes N/A

goodname 축구공 상품명 No 80


price 1000 상품 금액 No Fixed

ini_offer_period 옵션 미사용 시 정기결제 제공기간 No N/A

acceptmethod BILLAUTH(HPP):HPP(4) 소스 내 주석 참조 Yes N/A

INIregno 주민번호 앞 7 자리

Merchantreserved1 상점주문번호 설정(옵션)

merchantreserved3 예비 필드 No

N/A


resultcode “00” : 성공

2



이외 실패

resultmsg

Success message :

[신용카드|본인인증이 성공하였습니다.] Failure message :

[1223][인증실패|유효기간 오류]


cardcode 02 카드코드 2

tid INIpayBillINIBillTst20091216110906437565 거래번호 40

billkey 39ded0b6306b96b8b3166d02de7ffdd8639c5b24 BILL KEY. 40 nohpp

01112458745 모바일 인증 요청일경우만 반환 11

hcorp 이통사 정보

이 외에 version, clickcontrol 해당 필드의 값은 플러그인에서 자동으로 처리하므로

value 에 값을 임으로 채우지 마시기 바랍니다.

제공기간(ini_offer_period) 상세 설정 안내

- 월 자동결제 표시 M2, m2

예) <input type=hidden name=ini_offer_period value="M2"

- 연 자동결제 표시 Y2, y2

예) <input type=hidden name=ini_offer_period value="Y2">

- 24 시간 표시 T2, t2

예) <input type=hidden name=ini_offer_period value="T2">

acceptmethod 상세 설정 안내

- 이니시스와 계약한 빌링방법이 컨텐츠인경우

예) BILLAUTH(HPP):HPP(4)

- 이니시스와 계약한 빌링방법이 실물인경우

예) BILLAUTH(HPP):HPP(5)

- 주민번호 앞 7 자리 플러그인 자동입력 옵션 (바로 아래 INIregno 필드에 주민번호 앞 7 자리가 입력되어 있어야 함)



예) BILLAUTH(HPP): HPREG

계약 방법이 명확하지 않은 경우 이니시스 영업으로 문의하시기 바랍니다.

상점주문번호 설정안내

- 상점에서 빌키를 생성 요청시 주문번호를 설정할 경우

예) 상점주문번호 M1101

merchantReserved1 필드에 moid=M1101 을 설정한다.



5.2.2 빌링 요청 단계

실시간 빌링 API : REQREALBILL

실시간 빌링 입력 페이지 : INIreq_hpp.html

실시간 빌링 처리, 결과 페이지 : INIreq_hpp.asp


mid INIBillTst 상점 아이디 Yes Fixed

admin 1111 상점 개인키 패스워드 Yes Fixed

debug true/false true: 상세한 로그를 남김 Yes Fixed


paymethod “Card” or “HPP” 걸제수단 Yes Fixed

buyername 홍길동 구매자명 NO 30

buyertel 0105584878 구매자 연락처 NO 20

buyeremail [email protected] 구매자 이메일 NO 60

goodname 축구공 상품명 NO 80

price 1000 상품가격 yes Fixed

currency “WON” / “USD” 화페단위 KR : WON US : USD

yes Fixed

oid 384d91ld94 상점 주문번호 NO 40

billkey Billing Key Yes Fixed






regnumber 휴대폰의 유효성 확인 및 등록 단계에서 플러그인 창에서 입력했던

고객 주민번호 앞 7 자리 (법인 휴대폰 사용불가) NO


resultcode 00 : 성공

01 : 실패 결과 코드 2

resultmsg

Success message :

[신용카드|빌링이 정상적으로 이루어

졌습니다.] Fail message :

[1294][ 신용카드 |기간 만료 카드]


tid INIpayBillINIBillTst20091216142119937565

거래 번호 40

pgauthdate 20091216 승인 날짜(yyyyMMdd) 8

pgauthtime 210212 승인 시간(hhmmss) 6



6. 코드표

6.1 카드사 코드

코드 카드사 이름 코드 카드사 이름

01 외환 03 롯데

04 현대 06 국민

11 BC 12 삼성

13 LG 14 신한

15 한미 16 NH

17 하나 SK

21 해외비자 22 해외마스터

23 JCB 24 해외아멕스

25 해외다이너스

56 카카오뱅크

Documents

실시간 빌링서비스 트랜잭션 정의 - 이니시스 · 실시간 빌링서비스 트랜잭션 정의 Pub. Date: 2018. 10 Page 5 2. 실시간 빌링 서비스의 조건 1