INSTALL & SETUP GUIDE 이니시스
목차 이니라이트설치문서 (java version) 목차 1. 개요...3 1.1 개요... 3 2. 설치및설정...4 2.1 설치... 4 2.2 설정... 4 2.3 결과설정... 6 3. 상점대칭키갱신... 12 3.1 이니라이트상점대칭키생성 / 갱신... 12 Page ii Pub. Date: 2016. 2
1. 개요 1. 개요 1.1 개요 방화벽 (9102 포트오픈불가능 ) 설정이불가능하거나, 호스팅업체에서 이니페이결제모듈의설치를허용하지않는경우또는상점측에이니페이 모듈을유지보수할여건이되지않을경우, 이니라이트모듈로연동하여 이니페이결제모듈보다비교적쉽게설치하실수있습니다. 이니라이트모듈은다음과같은작업을수행합니다. 결제정보를암호화한다. 암호화된 전문을 https 프로토콜을 이용하여 이니라이트 결제서버와 통신한다. 결과로받은 xml 데이터를파싱한다. 결제모듈의설치는매우간단하나상점측페이지와연동하는부분은상점 측에서처리해주셔야합니다. Pub. Date: 2016. 2 Page 3
2. 설치및설정이니라이트설치문서 (java version) 2. 설치및설정 2.1 설치 제공된 inilite.zip 파일의압축을풀고웹서버의해당 application 폴더에파일을 복사하시면됩니다. ( 아래설명은 resin, tomcat 기준이며그외의벤더를사용하여 설치하시는중오류가발생하는경우 ts@inicis.com 으로문의주시기바랍니다. ) 디렉토리구조 inilite/ - / ( 이니라이트관련샘플페이지 ) - css/ ( 샘플페이지 css 폴더 ) - img/ ( 샘플페이지 images 폴더 ) - WEB-INF/ ( 이니라이트모듈디렉터리 ) - WEB-INF/lib ( 이니라이트모듈 jar files) - WEB-INF/log ( 기본로그디렉토리페이지에서변경 ) 2.2 설정 1. 파일복사 압축해제후해당 WEB-application 폴더에다음파일들을복사합니다. Page 4 Pub. Date: 2016. 2
2. 설치및설정 HTML & JSP 페이지 childwin.html css img index.html inilite.html inilite.jsp inilite_cancel.html inilite_cancel.jsp plugin_check.html JAR 파일 cancelresult.jar commons-codec-1.3.jar commons-httpclient-3.0.jar iniliteclient.jar jsr173_1.0_api.jar log4j-1.2.11.jar payresult.jar xbean.jar - 위 html 페이지들은해당 application 디렉터리에복사합니다.. - 해당 JAR 파일들은클래스패스를인식할수있는디렉터리에복사합니다. 톰켓, 레진인경우 WEB-INF/lib 에두시면됩니다. 톰켓등의 WAS 는반드시재시작을하셔야합니다. 2. JSP 파일설정 (inilite.jsp, inilite_cancel.jsp) - inilite.jsp ( 절대경로가 usr/local 인경우 ) 아래와같이로그경로를설정합니다. INIpayLite inipay = new INIpayLite("/usr/local/inilite/WEB-INF/log"); - inilite_cancel.jsp ( 절대경로가 usr/local 인경우 ) 아래와같이로그경로를설정합니다. INIpayLite inipay = new INIpayLite("/usr/local/inilite/WEB-INF/log"); 3. JVM(jdk) 설정파일 networkaddress.cache.ttl 항목설정 (java.security) - 이중화결제서비스이용을위해반드시필요한설정입니다. $JAVA_HOME/jre/lib/security/java.security 설정파일에 networkaddress.c ache.ttl=0 설정 Pub. Date: 2016. 2 Page 5
2. 설치및설정이니라이트설치문서 (java version) 2.3 결과설정 1. 결과값가져오기 모든결과값은아래와같은형식을통해가져올수있습니다. String value = (String) resultvalue.get("resultcode"); Page 6 Pub. Date: 2016. 2
2. 설치및설정 표 1 결과데이터. 변수명한글명내용크기 resultcode 결과코드 "00" 이면지불성공 2 byte resultmessage 결과내용지불결과에대한설명 200 byte mid 상점아이디 10 byte tid 거래번호 40 byte goodname 상품명 80 byte price 가격 12 byte paymethod 결제수단표 2. 참조 10 byte pgauthdate pgauthtime 이니시스승인일자이니시스승인시간 8 byte 6 byte buyername 구매자명 30 byte buyertel 구매자전화번호 40 byte buyeremail 구매자메일 60 byte oid 상점주문번호 40 byte cardnumber 카드번호 16 byte authcode 신용카드 승인번호 40 byte cardquota 할부기간 12 byte quotainterest 무이자할부여부 "1" 이면무이자할부 2 byte cardcode 신용카드사코드표 3. 참조 2 byte cardissuercode 카드발급사코드표 4. 참조 2 byte authcertain 본인인증 수행여부 "00" 이면수행 2 byte directbankcode 계좌이체은행표 4. 참조 2 byte rcash_rslt 현금영수증현금영수증발행여부 2 byte Pub. Date: 2016. 2 Page 7
2. 설치및설정이니라이트설치문서 (java version) nohpp 휴대폰번호 12 byte noars 전화번호전화결제시사용된번호 40 byte perno 송금자주민번호 13 byte vacct 가상계좌번호 16 byte vcdbank 입금할은행코드표 4. 참조 2 byte dtinput 입금예정일 8 byte nminput 송금자명 20 byte nmvacct 예금주명 20 byte codegw 사업자코드전화결제사업자코드 2 byte cultureid 컬쳐랜드 ID 20 byte 표 2 결제수단. Paymethod 한글명 Card 신용카드 ( 안심클릭및일반결제 ) VCard 신용카드 (ISP 결제 ) DirectBank HPP VBank Ars1588Bill 실시간은행계좌이체휴대폰결제가상계좌이체 1588 거는전화결제 PhoneBill 폰빌전화결제 ( 받는전화 ) Culture TEEN DGCL EDCL SKTG HPMN 문화상품권결제틴캐쉬결제 (Teen Cash) 스마트문상결제교육문화상품권결제 SK 상품권결제해피머니상품권 Page 8 Pub. Date: 2016. 2
2. 설치및설정 표 3 카드사코드 카드코드카드사카드코드카드사 01 하나 ( 외환 ) 카드 31 주택카드 ( 구동남카드 ) 03 롯데카드 ( 구동양 ) 32 광주카드 04 현대카드 ( 구다이너스 ) 33 전북카드 06 국민카드 34 하나카드 ( 구보람카드 ) 11 BC 카드 41 농협 ( 축협 ) 카드 12 삼성카드 42 한미카드 13 LG 카드 43 씨티카드 14 신한카드 44 평화카드 16 NH 카드 45 신세계카드 17 하나카드 21 해외비자카드 51 수협카드 22 해외마스터카드 52 제주카드 23 해외 JCB 카드 53 조흥카드 ( 구강원카드 ) 24 해외아맥스카드 25 해외다이너스카드 99 기타카드 표 4 카드발급사코드및은행코드 카드코드카드사카드코드카드사 02 한국산업은행 27 한미은행 03 기업은행 31 대구은행 04 국민은행 32 부산은행 05 외환은행 34 광주은행 06 주택은행 35 제주은행 07 수협중앙회 37 전북은행 11 농협중앙회 38 강원은행 Pub. Date: 2016. 2 Page 9
2. 설치및설정이니라이트설치문서 (java version) 12 단위농협 39 경남은행 16 축협중앙회 41 비씨카드 20 우리은행 53 씨티은행 21 조흥은행 54 홍콩샹하이은행 22 상업은행 70 신안상호금고 23 제일은행 71 우체국 24 한일은행 81 하나은행 25 서울은행 83 평화은행 26 신한은행 87 신세계 88 신한은행 ( 조흥통합 ) 표 5 은행 ( 증권사 ) 코드및은행코드 코드은행 ( 증권사 ) 이름코드은행 ( 증권사 ) 이름 02 한국산업은행 03 기업은행 04 국민은행 05 하나은행 ( 구외환 ) 06 국민은행 ( 구주택 ) 07 수협중앙회 11 농협중앙회 12 단위농협 16 축협중앙회 20 우리은행 21 구 ) 조흥은행 22 상업은행 23 SC 제일은행 24 한일은행 25 서울은행 26 구 ) 신한은행 27 한국씨티은행 ( 구한미 ) 31 대구은행 32 부산은행 34 광주은행 35 제주은행 37 전북은행 38 강원은행 39 경남은행 41 비씨카드 45 새마을금고 48 신용협동조합중앙회 50 상호저축은행 Page 10 Pub. Date: 2016. 2
2. 설치및설정 53 한국씨티은행 54 홍콩상하이은행 55 도이치은행 56 ABN 암로 57 JP 모건 59 미쓰비시도쿄은행 60 BOA(Bank of America) 64 산림조합 70 신안상호저축은행 71 우체국 81 하나은행 83 평화은행 87 신세계 88 신한 ( 통합 ) 은행 D1 유안타증권 ( 구동양증권 ) D2 현대증권 D3 미래에셋증권 D4 한국투자증권 D5 우리투자증권 D6 하이투자증권 D7 HMC 투자증권 D8 SK 증권 D9 대신증권 DA 하나대투증권 DB 굿모닝신한증권 DC 동부증권 DD 유진투자증권 DE 메리츠증권 DF 신영증권 DG 대우증권 DH 삼성증권 DI 교보증권 DJ 키움증권 DK 이트레이드 DL 솔로몬증권 DM 한화증권 DN NH 증권 DO 부국증권 DP LIG 증권 Pub. Date: 2016. 2 Page 11
3. 상점대칭키갱신이니라이트설치문서 (java version) 3. 상점대칭키갱신 3.1 이니라이트상점대칭키생성 / 갱신 이니라이트상점은대칭키를직접생성 / 갱신합니다. 대칭키생성은이니시스관리자페이지에서진행됩니다. 1. 상점계약정보중에서상점분류정보가 inilite 상점 ( 이니라이트상점 ) 으로설정됐는지확인합니다. ( 영업지원대표 : 02-3430-5843 ) 2. 상점관리자페이지 (https://iniweb.inicis.com) 에로그인하여 상점정보 메뉴에서 inilite key 생성갱신조회 을선택합니다. 3. 키생성갱신조회버튼이없는경우는 1) 항목을확인합니다. 1) 위에서 조회 버튼을클릭하면다음페이지가나타납니다. 처음갱신시에는 생성 버튼으로활성화되있습니다. 생성 또는 갱신 버튼을클릭하여 inilite key 생성을합니다. Page 12 Pub. Date: 2016. 2
3. 상점대칭키갱신 위그림에서 조회 를클릭하게되면다음화면이나타나며, 조회또는갱신이가능합니다. 2) 생성된대칭키 (inilite key) 는복사하여이니라이트결제요청페이지에서 merchantkey 필드의값으로설정합니다. Pub. Date: 2016. 2 Page 13