저작권 Copyright 2010 KG INICIS Co, Ltd. All rights reserved. 본 문서와 정보는 ( 주 ) 이니시스의 재산입니다. 또한, 모든 정보는 ( 주 ) 이니시스 소유 정보이며,( 주 ) 이니시스의사전동의없이본문서의어떤정보도열람, 복사

Transcription

1 버전정보 SETUP GUIDE KG 이니시스 페이지 1 / 52 Pub. Date:

2 저작권 Copyright 2010 KG INICIS Co, Ltd. All rights reserved. 본 문서와 정보는 ( 주 ) 이니시스의 재산입니다. 또한, 모든 정보는 ( 주 ) 이니시스 소유 정보이며,( 주 ) 이니시스의사전동의없이본문서의어떤정보도열람, 복사, 유용, 배포또는 타인과공유되어서는안됩니다. 본문서의정보는변경될수있으며변경시, 본문서는수정될 것입니다. 본문서의내용에관한어떠한의견이라도귀하의프로젝트또는사업담당자에게 전달하여주십시오. File: INIpayMobile_WEB_manual.doc Title: Author: 플랫폼개발팀 Version: 4.32 이연동모듈은모바일환경에최적화된연동모듈입니다. 이모듈을이용한 PC 거래구현및 PC 기반테스트으로인한기술지원은불가능하며, 거래손실및오류에대하여는당사에서책임지지않습니다. 페이지 2 / 52 Pub. Date:

3 목차 작성일수정내용작성자문서버전 Initialize Version 정기수 IOS9 업데이트관련 3. 앱환경의설치방법 (IOS) 내용 추가 오수민 V 수정이력표추가 이현욱 V4.04 옵션내용추가 1) 일반필드추가 - P_QUOTABASE : 신용카드할부기간지정 - P_VBANK_TM : 가상계좌입금기한시간설정 - P_CHARSET : 인증, 승인결과받을캐릭터셋설정 2) P_RESERVED 옵션추가 below1000 : 1000 원미만결제허용 - d_card, d_quota : 신용카드결제창직접호출 - app_scheme : 가맹점 App Scheme 설정 - extension_enable : 3rd party 기능활성화 - hpp_corp : 통신사선택 - merc_noint, noint_quota : 상점무이자 오수민 V4.05 3) 부록 이니시스카드코드추가 앱환경의설치방법 (IOS) - 안심클릭공인인증 App custom scheme 내용추가 이현욱 V 은행사코드업데이트오수민 V P_RESERVED 옵션의 app_scheme 값에대한부연설명 추가 오수민 V IOS 시티앱카드스키마추가김재호 V IOS9 버전 Application 구현시, 주의사항내용추가 - PAYCO Scheme 추가 이현욱 V 유의사항 14 ( 앱 USER AGENT ) 주의사항내용추가 김재호 V 안드로이드 / IOS( IOS10 대응 ) 코드수정 김재호 V syrup 앱카드스키마추가 김재호 V 뱅크월렛내용추가 오수민 V4.14 페이지 3 / 52 Pub. Date:

4 목차 1) P_RESERVED 옵션추가 - d_kwpy : 뱅크월렛결제페이지바로가기 2) 뱅크월렛앱스키마추가 - bankwallet:// 뱅크월렛내용추가 - 5 번목차추가 : 뱅크월렛연동방법 ( 현금영수증처리, 승인결과수신등 ) 오수민 V P_SRC_CODE 페이코추가 3 rd party 앱브라우저결제이슈내용추가 김재호 V 아웃바운드 IP 추가오수민 V 농협올원페이앱스키마추가김재호 V 씨티카드신규앱스키마추가김재호 V 휴대폰결제승인결과이통사정보수정 (P_HPP_CORP 응답값변경 ) 김재호 V 카카오톡최적화이슈및 ios third-party 스키마추가김재호 V 삼성페이연동시유의사항추가김재호 V LPAY 앱스키마추가, LPAY app_scheme 옵션지원지불수단추가 김재호 V 페이코 app_scheme 옵션지원지불수단추가 김재호 V 하나카드공인인증앱스키마추가 오수민 V 카드코드추가 ( 페이코, 카카오뱅크 ) 김재호 V4.26 페이코 ( 포인트 100% 사용 ) 발급사수정 이니시스카드코드 98 에기입되어있던 페이코 ( 포인트 100% 사용 ) 을발급사로이동 오수민 V trs 결제현금영수증승인정보추가김재호 V 카카오페이스키마추가 (kakaotalk://) 카카오머니발급사코드 (97) 추가 오수민 V OUTBOUND 방화벽도메인정보추가김재호 V SSGPAY 스키마추가 (shinsegaeeasypayment://) 승인결과내 P_SRC_CODE 삼성페이 (B), LPAY(L), 오수민 V4.31 페이지 4 / 52 Pub. Date:

5 목차 SSGPAY(G), 카카오페이 (O) 추가 카드코드추가 ( 케이뱅크 ) 오수민 V4.32 페이지 5 / 52 Pub. Date:

6 목차 목 차 1. 기본적인설치방법 연동 Flow 결제창 Open ( 주문정보전달 ) 1 접속주소및일반필드 결제창 Open ( 주문정보전달 ) 2 복합필드 결제페이지구성예제 Transaction 방식의구성 결제페이지구성예제 Transaction 방식의구성 인증결과수신 (only 2 Transaction) 승인요청송신및승인처리결과수신 (only 2 Transaction) 승인결과수신필드상세 (only 2 Transaction) 가상계좌방식 과 계좌이체방식 상세안내 Transaction 방식에서결제완료후결과수신 P_NOTI_URL 수신후, 처리방법 주의사항 1 <Form Encode issue> 주의사항 2 <UrlEncode issue> 주의사항 3 <iframe issue> 주의사항 4 <Parameter issue> 주의사항 5 < 문화상품권결제시, P_UNAME 필드설정 issue> 주의사항 6 < 가상계좌채번시 P_NOTI_URL issue> 주의사항 7 < 모바일거래결제취소 issue> 주의사항 8 <OUTBOUND 방화벽 issue> 주의사항 9 <DNS 설정관련 issue> 주의사항 9 < 인증결과수신및승인결과수신시 issue> 주의사항 10 <P_NEXT_URL 의 Scheme issue> 주의사항 11 < 브라우져환경에서의쿠키허용 issue> 주의사항 12 < 인증결과수신시 Method issue> 주의사항 13 < 네이버 / 카카오톡앱환경최적화 issue> 주의사항 14 < 안드로이드 /IOS 앱 USER AGENT 수정 > 주의사항 15 < 아이폰 3 rd party( 제3 공급자 ) 앱브라우저결제 issue> 주의사항 16 삼성페이연동시유의사항 앱환경의설치방법 ( 안드로이드 ) 기본적인설치방법 A. mobileisp 연동방법 - 앱미설치체크로직직접구현 or 자동체크 B. mobileisp 연동방법 인증결과전송 C. 안심클릭결제시, 카드사백신앱연동 D. 결제금액이 30만원이상일때의공인인증앱연동방법 E. Android API Level 21 이상일때, 체크사항 페이지 6 / 52 Pub. Date:

7 목차 3. 앱환경의설치방법 (IOS) 기본적인설치방법 A. mobileisp 연동방법 B. 안심클릭결제시, 카드사백신앱연동 C. 카드사앱연동방법 D. 쿠키설정 E. IOS9버전 Application 구현시, 주의사항 케이페이연동방법 케이페이사용전확인사항 A. Android WebView 에서의처리 B. IOS WebView 에서의처리 C. 케이페이바로가기옵션 D. 케이페이승인결과수신방법 뱅크월렛연동방법 주의사항 뱅크월렛결제 Flow 뱅크월렛바로가기 뱅크월렛승인결과수신 삼성월렛연동방법 삼성월렛사용전확인사항 A. Android WebView 에서의처리 B. IOS WebView 에서의처리 C. 삼성월렛바로가기옵션 모바일신에스크로사용방법안내 모바일신에스크로사용가능지불수단 A. 설정방법 부록 카드사 ( 매입사 ) 코드 카드발급사 ( 은행사 ) 코드 이니시스카드코드 페이지 7 / 52 Pub. Date:

8 기본적인설치방법 1. 기본적인설치방법 1-1. 연동 Flow 이니페이모바일 TM 은복잡한카드사와의연계를당사에서처리하고, 가맹점에는통일화된규격을제시함에따라, 보다편리하게모바일결제시스템을구축할수있게합니다. 인증 / 승인분리방식 ( 이하 2 Transaction 이라명명 ) 을기본 Flow 로하며, 일부지불수단에한하여, 인증 / 승인통합방식 ( 이하 1 Transaction 이라명명 ) 을사용합니다. [2 Transaction 방식 Flow, 신용카드, 휴대폰, 문화상품권, 해피머니상품권, 스마트문상 ] 1 결제페이지요청 ( 주문정보인입 ) 2 결제페이지노출 3 결제정보입력및인증요청 4 인증결과전송 5 승인요청 (Http-Socket Back 단요청 ) 6 승인결과출력 (Http-Socket Receive Data) 결과출력 가맹점 구매자 이니페이모바일 TM [1 Transaction 방식 Flow, 계좌이체, 가상계좌, 케이페이, 삼성페이 (KB)] 1 결제페이지요청 ( 주문정보인입 ) 2 결제페이지노출 3 결제정보입력및인증요청 별도 트랜 잭션 4 가맹점완료페이지이동 4 승인결과전송 (Http-Socket Back 단전송 ) 5 승인결과정상수신출력 (Http-Socket Receive Data) 6 결제완료확인 7 결제결과출력 노티 방식 가맹점 구매자 이니페이모바일 TM 페이지 8 / 52 Pub. Date:

9 기본적인설치방법 1-2. 결제창 Open ( 주문정보전달 ) 1 접속주소및일반필드 주문정보전달이란, 하기의 Step 을의미합니다. 1 결제페이지요청 ( 주문정보인입 ) 2 결제페이지노출 3 결제정보입력및인증요청 4 인증결과전송 5 승인요청 (Http-Socket Back 단요청 ) 6 승인결과출력 (Http-Socket Receive Data) 결과출력 가맹점 구매자 이니페이모바일 TM 상점페이지에서이니페이모바일 TM 접속시, 지불수단별로상이한 URL 을사용합니다. 이에, 하기의 URL 을참고하시기바랍니다. Url 신용카드계좌이체가상계좌휴대폰문화상품권해피머니상품권스마트문상전자지갑 이니페이모바일 TM 접속시, 결제페이지를구성하기위해서는하기 Parameter를필요로합니다. 양식예시 : <input type= hidden name= 필드명 value= 값예시 /> 필드명 목 적 부가설명및주의사항 크 기 필수여부 전지불수단공통필드 P_MID 상점아이디 계약된당사발급아이디 Char(10) 필수 P_OID 주문번호 한글을제외한, 숫자 / 영문 / 특수기호의형태필수대상 Char(40) 필수대상 : 가상계좌외선택 P_AMT 거래금액 단위표시기호 ( 콤마 ) 를반드시제거요망 Char(8) 필수 P_UNAME 고객성명 Char(30) 필수 P_MNAME 가맹점이름 선택 P_NOTI 기타주문정보 이값은가맹점에서이용하는추가정보 Char(800) 선택 페이지 9 / 52 Pub. Date:

10 기본적인설치방법 필드로전달한값이그대로반환됩니다. 결제처리시, 꼭필요한내용만사용하세요. 800byte 를초과하는 P_NOTI 의값은차후문제가생길여지가있으니반드시 800byte 를초과하지않도록설정해야합니다. P_GOODS 결제상품명 Char(80) 필수구매자 - 를포함한번호를적어주세요. P_MOBILE Char(15) 선택휴대폰번호구현예시 : 구매자 P_ 구현예시 : abc@abc.com Char(30) 선택 사용자의인증이완료될때, 이 Url 로인증결과를전달합니다. Method : post or get (issue : 1-24 보기 ) 예외대상인증결과수신 P_NEXT_URL Scheme : https (issue : 1-22 보기 ) Char(250) 외 Url Parameters : 0. 필수인증결과수신 (only 2 Transaction) 참고예외대상 : 계좌이체, 삼성월렛, Kpay 가맹점과인증 / 승인과정을거치지않고승인결과를통보하는용도로사용합니다. 단, 가상계좌의경우, 입금완료시각이비동기식이므로, 입금완료통보를위해사용됩니다. P_NOTI_URL 승인결과통보 Url Method : post Parameters : *INIpayMobile Receive GUIDE Char(250) 적용대상필수 참조 적용대상 : 계좌이체, 가상계좌, 삼성월렛, Kpay 이 Url 은네트워크사정에따라중복전송 될수있으니, 중복수신여부체크루틴을 반드시구현하시기바랍니다. 승인결과통보 Url 을사용하는 ( 비동기식으로승인결과를통보받는 ) 지불수단에서사용되는방식으로, 사용자가 이니페이모바일 TM 에서모든결제과정을 P_RETURN_U RL 결제완료 Url 마친후, 이동할가맹점 Url 입니다. 이 Url 은당사에서변조없이그대로호출하여 Char(250) 적용대상필수 드립니다. Method : get 적용대상 : 계좌이체, 삼성월렛, Kpay 페이지 10 / 52 Pub. Date:

11 기본적인설치방법 구현예시 : 영수증에표기할부가세금액 P_TAX 부가세 주 의 : 전체금액의 10% 이하로설정 선택 대상 : 부가세업체정함 설정업체에한함 P_TAXFREE 비과세 과세되지않는금액대상 : 부가세업체정함 설정업체에한함 선택 상품의제공기간을설정해야하는경우, 사 용되는옵션으로, 이니페이모바일에디스 플레이하는용도로만사용됩니다. 1) 상점에서 16 자리값입력시 ( ): 날짜표시 Ex ~ ) 상점에서 24 자리값입력시 P_OFFER_PE RIOD 제공기간 ( ): 날짜시간표시 Ex :30 ~ :30 선택 3) 상점에서 M2 값설정시 (M2) : 월자동결제 4) 상점에서 Y2 값설정시 (Y2): 연자동결제 5) 1 ~ 4 번의조건을만족하지않으면 ( 글 자길이가맞지않거나문자를삽입하는경 우 ) 별도제공기간없음 으로표기 신용카드전용필드 설정시, 해당카드코드에해당하는카드가 P_CARD_OPT ION 신용카드우선선택옵션 선택된채로 Display 됩니다. ( 타카드선택가능 ) 선택 적용예시 : selcode=14 선택된카드리스트만출력되며, 나머지 카드리스트는출력되지않습니다 적용예시 : 롯데, 외환, BC 카드만사용할 P_ONLY_CAR DCODE 신용카드노출제한옵션 경우, 롯데카드코드 : 03, 선택 외환카드코드 : 01, BC 카드코드 : 11 이므로, 03:01:11 로설정 50,000 원이상결제시, 할부기간지정 P_QUOTABA SE 신용카드할부기간지정 (36 개월 MAX) Ex. 01:02:03: 은일시불, 02 는 2 개월등등 선택 페이지 11 / 52 Pub. Date:

12 기본적인설치방법 휴대폰전용필드 P_HPP_METH OD 실물여부구분 컨텐츠일경우 : 1 실물일경우 : 2 컨텐츠 / 실물여부는계약담당자에게확인요 휴대폰결제필수 가상계좌전용필드 P_VBANK_DT 가상계좌입금기한날짜 설정을하지않으면, 요청일 + 10 일로자동설정됩니다. Ex 선택 P_VBANK_T M 가상계좌입금기한시간 시분까지설정가능합니다. (4 자리 ) Ex 선택 기타옵션필드 인증, 승인결과 CHARSET 정의 default 는 euc-kr 이며, 인증 승인결과를 P_CHARSET 캐릭터셋설정 utf-8 로받기를원하시면해당옵션설정 선택 값을 utf8 로하시면됩니다. Ex. utf 결제창 Open ( 주문정보전달 ) 2 복합필드 이번장에서안내하는복합필드는하나의 input 에엔드 (&) 를통해추가하는형태를띕니다. 양식예시 : <input type= hidden name= P_RESERVED value= twotrs_isp=y&block_isp=y& /> 필드명목적 Variable Value 및부가설명 twotrs_isp=y& 신용카드필수옵션 block_isp=y& twotrs_isp_noti= 신용카드거래시, 반드시입력되어야하는값입니다. N P_RESERVED 가상계좌현금영수증사용여부 vbank_receipt=y 가상계좌는기본적으로현금영수증입력란이없습니다. 이옵션을사용하면, 현금영수증입력란이 Display 됩니다. 계좌이체는기본적으로현금영수증입력란이 Display 계좌이체현금영수증 bank_receipt=n 됩니다. 이옵션을사용하면, 현금영수증입력란이사라집니다. 사용여부 뱅크월렛결제 : 현금영수증을사용하는가맹점의 경우현금영수증이무조건자동발행처리됩니다. 페이지 12 / 52 Pub. Date:

13 기본적인설치방법 카드포인트사용여부앱호출시, Intent 형식으로호출여부 30 만원이상결제시신에스크로사용여부 1000 원미만결제허용신용카드결제창직접호출가맹점 App scheme 설정통신사선택신용카드상점무이자 cp_yn=y apprun_check=y ismart_use_sign =Y useescrow=y below1000=y d_card=00( 코드 ) d_quota=00( 할부개월 ) app_scheme= 스키마값 hpp_corp= 통신사 merc_noint=y noint_quota=00-00( 카드-개월 ) 신용카드에한하며, 신용카드포인트를사용가능하게하는옵션입니다. 이옵션을사용하면, 신용카드사의포인트를사용할수있습니다. 카드사창에서호출되는백신앱및앱카드를제외한, 이니페이모바일 TM 에서직접호출하는앱 (ISP 등 ) 의호출방식을 Intent 방식으로작동시키며, 설치유무체크를이니페이모바일 TM 에서직접컨트롤하는기능을수행합니다. (Chrome, safari, ff) * 해당기능은 Android 단말기에서만정상동작하며, app_scheme 옵션과같이사용할수없습니다. Android 이옵션필요없음 ( 해당없음 ) 웹형태 ismart_use_sign=y IOS ismart_use_sign=y& 앱형태 mall_app_name= 가맹점스키마 신에스크로약관동의 와 구매자본인확인 페이지가포함된신에스크로결제창을호출합니다. 신용카드거래시, 1000 원미만결제를허용하는옵션입니다. 옵션을사용하지않으면, 자동미사용됩니다. 신용카드결제창 ( 안심클릭 / ISP) 을직접호출하는옵션입니다. 설정방법 : d_card=00( 카드코드 ) d_quota=00( 할부개월 ) Ex. d_card=04&d_quota=03 가맹점 APP 및타사앱을통해결제진행시아래지불수단을사용할경우설정 (IOS 지원 ) ISP 2trs, 뱅크월렛, 은련카드, LPAY, 페이코 Ex. app_scheme= 스키마명 :// ( 스키마명뒤에 :// 는꼭입력해주셔야합니다.) 휴대폰결제업체 (SKT, KTF, LGT) 를지정할수있는옵션입니다. Ex. SKT 만사용 hpp_corp=skt SKT, KTF 사용 - hpp_corp=skt:ktf 무이자이벤트진행시, 상점부담무이자옵션입니다. ( 대표무이자및분담무이자아님 ) 설정방법 : merc_noint = Y noint_quota=00-00:00( 카드-개월 : 개월 ) ** [ 카드-월 : 월 ]^ 카드는 OO 두자리, 할부개월 01 1 ** 카드추가시, 구분자는 ^ 입니다. ** 잘못된예 11-02:04:06 페이지 13 / 52 Pub. Date:

14 기본적인설치방법 Ex. merc_noint=y& noint_quota=11-2:3^06-3:6:9:12 상점부담무이자계약가맹점만사용가능합니다. ( 영업담당자문의 ) 뱅크월렛은금융결제원에서제공하는간편결제앱뱅크월렛입니다. d_kwpy=y 바로가기해당옵션사용시, 계좌이체탭을 display 하지않고바로뱅크월렛결제페이지로이동합니다. ( 상기기능외, 옵션에대하여는별도문의바랍니다 ) 앱내 WebView 로구현하는경우, P_RESERVED 옵션이추가됩니다. ( 2장. 앱환경의설치방법 ( 안드로이드 ) 의 2.B. mobileisp 연동방법 ) 를참고하십시오. 복합필드설정, 이방법추천! 신용카드거래시, intent 방식으로앱을호출할수있도록하기와같이기본적으로구성하는것을권장합니다. block_isp=y&twotrs_isp=y&twotrs_isp_noti=n&apprun_check=y 하기는복합필드의 apprun_check=y 사용 / 미사용시, 로직에대한상세안내입니다. <apprun_check=y 미사용시 > - ISP 앱이없을땐, 오류페이지가발생합니다. Step1) 약관동의 Step2) 카드선택 Step3) ISP 결제시작 Step4) ISP 없을때 페이지 14 / 52 Pub. Date:

15 기본적인설치방법 ( 이어서 ) <apprun_check=y 사용시 > - ISP 앱이없다면, 앱스토어이동및설치후, 결제를이어서진 행할수있습니다. Step1) 약관동의 상동 Step3) ISP 결제시작 Step2) 카드선택 상동 Step4) ISP 없을때 Step5) 앱설치후 페이지 15 / 52 Pub. Date:

16 기본적인설치방법 페이지 16 / 52 Pub. Date:

17 기본적인설치방법 1-4. 결제페이지구성예제 Transaction 방식의구성 하기예제는 2 Transaction 구성에한한예제입니다. (head,body 부생략 ) <meta http-equiv= Content-Type content= text/html;charset=euc-kr /> <script> function formsubmit(){ document.getelementbyid( form1 ).submit(); </script> <form id= form1 name= form1 method= post action= 지불수단 URL > <input type= hidden name= P_GOODS value= 테스트상품 /> <input type= hidden name= P_MID value= 상점아이디 /> <input type= hidden name= P_AMT value= 상품가격 /> <input type= hidden name= P_OID value= /> <input type= hidden name= P_ value= abc@abc.com /> <input type= hidden name= P_UNAME value= 구매자명 /> <input type= hidden name= P_NEXT_URL value= 가맹점 Next_Url /> <input type= button onclick= formsubmit(); /> </form> 1-5. 결제페이지구성예제 Transaction 방식의구성 하기예제는 1 Transaction 구성에한한예제입니다. (head,body 부생략 ) <meta http-equiv= Content-Type content= text/html;charset=euc-kr /> <script> function formsubmit(){ document.getelementbyid( form1 ).submit(); </script> <form id= form1 name= form1 method= post action= 지불수단 URL > <input type= hidden name= P_GOODS value= 테스트상품 /> <input type= hidden name= P_MID value= 상점아이디 /> <input type= hidden name= P_AMT value= 상품가격 /> <input type= hidden name= P_OID value= /> <input type= hidden name= P_ value= abc@abc.com /> <input type= hidden name= P_UNAME value= 구매자명 /> <input type= hidden name= P_NOTI_URL value= 가맹점 Noti_Url /> <input type= hidden name= P_RETURN_URL value= 가맹점 Return_Url /> <input type= button onclick= formsubmit(); /> </form> 페이지 17 / 52 Pub. Date:

18 기본적인설치방법 1-6. 인증결과수신 (only 2 Transaction) 1-6 ~ 1-8 장은 2 Transaction 을위한설명페이지입니다. 1 Transaction 방식은 1-1. 연동 Flow 장을참고하세요. 인증결과수신 이란, 하기의 Step 을의미합니다. 1 결제페이지요청 ( 주문정보인입 ) 2 결제페이지노출 3 결제정보입력및인증요청 4 인증결과전송 5 승인요청 (Http-Socket Back 단요청 ) 6 승인결과출력 (Http-Socket Receive Data) 결과출력 가맹점 구매자 이니페이모바일 TM 2 Transaction 거래의경우, 1-2. 결제창 Open ( 주문정보전달 ) 접속주소및일반필드장 에기재된, P_NEXT_URL 로인증결과를전달합니다. 이때이니페이모바일 TM 에서 P_NEXT_URL 로전달하는 Parameter 는하기와같습니다. 필드명목적비고 P_STATUS 인증상태성공시 00, 그외실패 P_RMESG1 결과메시지 P_TID 인증거래번호 Char(40) / 성공시에만반환 P_REQ_URL 승인요청 Url 가맹점에서이니페이모바일로승인요청을할때, 사용되는 Url 입니다. 거래건마다상이한 URL 이전달됩니다. 따라서, 절대고정하여사용하지마십시오. Http Scheme 은 https 를사용합니다. P_NOTI 기타주문정보 최초거래시주문정보에 P_NOTI 를설정하셨다면, 그값을전 달받을수있습니다. 이값은 P_NOTI 값을그대로리턴합니 다. 뱅크월렛지불수단의경우, 상기의인증결과값이아닌, (1-8. 승인결과수신필드상세 (only 2 Transaction) 의값이전달됩니다. 이점유의바랍니다. 페이지 18 / 52 Pub. Date:

19 기본적인설치방법 또한, 당사에서인증결과송신시사용하는 Method 는 post, get 을선택적으로사용하오니, 두가지방식을모두수용할수있도록처리바랍니다 승인요청송신및승인처리결과수신 (only 2 Transaction) 승인요청및결과수신 이란, 하기의 Step 을의미합니다. 1 결제페이지요청 ( 주문정보인입 ) 2 결제페이지노출 3 결제정보입력및인증요청 4 인증결과전송 5 승인요청 (Http-Socket Back 단요청 ) 6 승인결과출력 (Http-Socket Receive Data) 결과출력 가맹점 구매자 이니페이모바일 TM 승인요청시에사용되는 P_REQ_URL( 승인요청 Url) 은 Front-End 단에서 Submit 을하지않고, Http-Socket 통신을통해 Back-End 단으로요청하셔야합니다. 당사 P_REQ_URL 은승인과정을거친후, 가맹점의특정 Url 로승인결과를전송하지않고, 페이지상에, echo 를통해결과를출력하기만합니다. 따라서, 승인결과메시지는 Http-Socket 의 Receive-Data 로수신받으셔야합니다. 인증요청을받은후, 승인요청하는 Flow 는하기의방식을참고하십시오. 현재 URL : 이니시스이니페이모바일 TM 에서 P_NEXT_URL 로인증결과송신 현재 URL : P_NEXT_URL 인증결과수신후, P_REQ_URL 호출 (Http-Socket) 현재 URL : P_NEXT_URL 이니시스인증결과수신및승인처리후결과출력 현재 URL : P_NEXT_URL 파란색 : 이니페이모바일 TM, 붉은색 : 가맹점 상점에서호출한 Socket 의 Receive-Data 로 출력된결과수신 승인요청시, 사용하는통신규격은하기와같습니다. 페이지 19 / 52 Pub. Date:

20 기본적인설치방법 통신수단 통신방식 Http-Socket post 승인요청시, 하기의필드를반드시첨부하셔야합니다. 필드명목적비고 P_TID 인증거래번호인증결과수신시, 포함된인증거래번호 (P_TID) P_MID 상점아이디거래시사용된, 당사발급아이디 Http-Socket 을이용한승인요청의샘플코드는하기와같습니다. ( 하기코드내함수는직접구현하셔야합니다. 하기코드는로직안내를위해작성된예시입니다 ) <? //REQUEST ************************************ $P_STATUS = $_POST[ P_STATUS ]; $P_REQ_URL = $_POST[ P_REQ_URL ]; $P_TID = $_POST[ P_TID ]; $P_MID = $_POST[ P_MID ]; function makeparam($p_tid, $P_MID){ return P_TID=.$P_TID. &P_MID=.$P_MID; function parsedata($receivemsg) { // 승인결과 Parse $returnarr = explode( &,$receivemsg); foreach($returnarr as $value){ $tmparr = explode( =,$value); $returnarr[] = $tmparr; function chktid($p_tid); // 기승인 TID 여부확인 function savetid($p_tid); // 승인된 TID 를 DB 에저장 function setsocket($host, $port); // 소켓생성 function connectsocket($sock); // 소켓연결 function requestsocket($sock,$param); // 데이터송신 function responsesocket(); // 데이터수신 if($p_status== 00 && chktid($p_tid)){ $sock = setsocket($p_req_url,443); //https connection connectsocket($sock); requestsocket($sock,makeparam($p_tid, $P_MID)); $returndata = responsesocket(); $returndataarr = parsedata($returndata); //$returndataarr 에승인결과저장 savetid($p_tid);?> 페이지 20 / 52 Pub. Date:

21 기본적인설치방법 1-8. 승인결과수신필드상세 (only 2 Transaction) 지불수단 필드명 목 적 비 고 성공 :00 00 이외실패 주의 : 반드시 00 이외의모든 결과는실패로처리하셔야합니다. ( 지불수단및원천지불사의 P_STATUS 거래상태 에러내용에따라 2~4 자리로전송될 수있습니다. 모든지불수단 공통적으로결제성공시 P_STATUS=00 으로전송되나, 결제실패시에는상이하게전송될 수있습니다.) P_TID 거래번호 char(40) char(10) CARD(ISP, 안심클릭, 국민앱카드, 케이 페이 ) HPMN( 해피머니 ) P_TYPE 지불수단 CULTURE( 문화상품권 ) 공통 MOBILE( 휴대폰 ) VBANK( 가상계좌 ) EWALLET( 전자지갑 ) ETC_( 알리페이, 페이팔외기타 ) P_AUTH_DT 승인일자 char(14) YYYYmmddHHmmss P_MID 상점아이디 char(10) P_OID 상점주문번호 char(100) P_AMT 거래금액 char(8) P_UNAME 주문자명 char(30) P_MNAME 가맹점이름 주문정보에입력한값반환 P_RMESG1 메시지 1 char(500) 지불결과메시지 char(800) P_NOTI 주문정보 주문정보에입력한값반환 P_NOTEURL 가맹점전달거래요청시입력한값을그대로 NOTI URL 반환합니다. P_NEXT_URL 가맹점전달거래요청시입력한값을그대로 NEXT URL 반환합니다. 페이지 21 / 52 Pub. Date:

22 기본적인설치방법 신용카드계약관계에따라틀림 P_CARD_NUM 카드번호 U 포인트 P_CARD_ISSUER_CO char(2) 발급사코드 DE P_CARD_MEMBER_N 자체가맹점일경우만해당가맹점번호 UM P_CARD_PURCHASE_ 자체가맹점일경우만해당매입사코드 CODE P_CARD_PRTC_COD E 부분취소가능여부 부분취소가능 : 1, 부분취소불가능 : 0 P_CARD_INTEREST 무이자할부여부 0 : 일반, 1 : 무이자 0 : 신용카드, 신용카드 P_CARD_CHECKFLA 체크카드여부 1 : 체크카드 G 2 : 기프트카드 P_RMESG2 메시지 2 char(500) 신용카드할부개월수 P_FN_CD1 카드코드 char(4) P_AUTH_NO 승인번호 char(30) 신용카드거래에서만사용합니다 P_ISP_CARDCODE VP 카드코드 P_FN_NM 결제카드한글명 BC카드, P_EVENT_CODE 이벤트코드 A1,A2 등등 휴대폰 char(3) P_HPP_CORP 휴대폰통신사 *** P_HPP_NUM 결제휴대폰번호 전자지갑 P_EWALLET_TYPE 전자지갑종류 YPAY : 옐로페이 KWPY : 뱅크월렛 P : 페이핀 K : 국민앱카드 C: 페이코앱연동 P_SRC_CODE 앱연동여부 B: 삼성페이결제구분 L: LPAY O: 카카오페이 G: SSGPAY P_CSHR_CODE 처리상태 : 정상, 그외 : 오류 현금 P_CSHR_MSG 처리메시지 영수증현금영수증총금액 = P_CSHR_AMT 총금액공급가액 + 세금 + 봉사료 페이지 22 / 52 Pub. Date:

23 기본적인설치방법 P_CSHR_SUP_AMT 공급가액 P_CSHR_TAX 세금 P_CSHR_SRVC_AMT 봉사료 P_CSHR_TYPE 용도구분 0: 소득공제용, 1: 지출증빙용 P_CSHR_DT 발행시간 P_CSHR_AUTH_NO 발행번호 가상계좌의경우, 입금완료시, 생성되어모바일내채번시에는전달되지않습니다. 페이지 23 / 52 Pub. Date:

24 기본적인설치방법 1-9. 가상계좌방식 과 계좌이체방식 상세안내 가상계좌방식 과 계좌이체방식 은입금통보등의과정을필요로하기때문에, 상기에 안내한방식과다소다른점이있습니다. 하기에는가상계좌와계좌이체에서각기사용하는 인증완료후, 이동페이지 와, 입금통보혹은승인완료통보 방식에대하여안내합니다. 인증완료후이동 URL(Front단 ) 입금사실통보 URL(Back 단 ) 계좌이체 P_RETURN_URL( 송신정보없음 ) P_NOTI_URL( 입금완료송신 ) 가상계좌 P_NEXT_URL( 인증결과송신 ) P_NOTI_URL(, 채번정보송신, 입금완료송신 ) 하기에는호출된, P_NEXT_URL 에전달될파라미터입니다. 계좌이체 P_RETURN_URL 을호출하며, 결제성공을판단할수있는파라미터전송치아니함. 가상계좌 (1-8. 승인결과수신필드상세 (only 2 Transaction) 의공통필드 ) 외하기필드 P_VACT_NUM 입금할계좌번호 char(20) P_VACT_DATE 입금마감일자 char(8) : yyyymmdd P_VACT_TIME 입금마감시간 char(6) hhmmss P_VACT_NAME 계좌주명 P_VACT_BANK_CODE 은행코드 char(2) P_NOTI_URL 로전송되는승인결과는 INIpayMobile_Receive_API_manual 를참고바랍니다. 가상계좌 Flow 는하기와같습니다. 1 결제페이지요청 ( 주문정보인입 ) 2 결제페이지노출 별도 트랜 잭션 3 결제정보입력및인증요청 4 P_NEXT_URL 로이동 5 가상계좌채번정보전달 (Http-Socket Back 단전송 ) 6 노티정상수신출력 (Http-Socket Receive Data) 7 입금확인시, 결과전송 (Http-Socket Back 단전송 ) 8 노티정상수신출력 (Http-Socket Receive Data) 9 결제완료확인 10 결제결과출력 노티 방식 가맹점구매자이니페이모바일 TM 가상계좌는상기와같이채번시 1회, 입금확인후 1회, 총 2회노티를통해통보합니다. 페이지 24 / 52 Pub. Date:

25 기본적인설치방법 계좌이체 Flow 는하기와같습니다. << 계좌이체 Flow>> 1 결제페이지요청 ( 주문정보인입 ) 별도 트랜 잭션 2 결제페이지노출 3 결제정보입력및인증요청 4 P_RETURN_URL 로이동 4 입금확인시, 결과전송 (Http-Socket Back 단전송 ) 5 노티정상수신출력 (Http-Socket Receive Data) 6 결제완료확인 7 결제결과출력 노티 방식 가맹점 구매자 이니페이모바일 TM 상기에안내한바와같이, 가상계좌방식과계좌이체방식, 그리고기타방식 ( 신용카드등 ) 의차이점이있사오니, 이점유의하시기바랍니다 Transaction 방식에서결제완료후결과수신 P_NOTI_URL 로전송되는파라미터및값은별첨문서인 INIpayMobile_Receive_API_manual 를참고하여주시기바랍니다. 1 P_NOTI_URL 은네트워크사정에따라 1회이상발생될수있사오니, 중복호출여부를체크하는루틴을반드시구현하십시오. 2 NOTI 를통한결과송신은하기의조건에따라수행됩니다. 24시간이내재전송가능 24시간이후시퀀스종료 재전송주기약 10분 P_NOTI_URL 수신후, 처리방법 당사 Back 단에서전송된 Noti 는하기의조건을충족하지않을경우, 재전송루틴을수행하게됩니다. 따라서, ( Transaction 방식에서결제완료후결과수신 ) 장에서안내한바와같이중복체크루틴을반드시구현하시고, 하기의조건을충족하여주시기바랍니다. 1 Noti 수신후, P_NOTI_URL 에 OK 만출력요망. 2 대문자 OK 외 html 및공백, 개행문자불허 페이지 25 / 52 Pub. Date:

26 기본적인설치방법 주의사항 1 <Form Encode issue> 이니페이모바일 TM 은 EUC-KR 을사용합니다. 이에, 반드시 EUC-KR 인코딩으로전송바랍니다. <form method= post accept-charset= euc-kr > 주의사항 2 <UrlEncode issue> 상점페이지에서이니페이모바일 TM 로주문정보전송시, Form Data 가 Double Encoded 되어 전송되는경우가있습니다. 하기의 Case 를확인하시어, Encoding 여부를체크하십시오. 가맹점 이니페이모바일 TM BASE 호출 BASE Web-Browser Web-Browser 필요없음 Url-Encode 여부 App WebView 체크요망 App Web-Browser 필요없음 urlencode 구현시, 필드명은미포함한, input 의 value 부만 encoding 해야합니다. 예시 ) <input type= hidden name= P_RESERVED value= urlencode(value) /> 주의사항 3 <iframe issue> 이니페이모바일 TM 을 Non-Iframe 에최적화되어있습니다. 이에, iframe 내에구현하는것을 권장하지않습니다. iframe 구현에따른문제에대하여는당사에서책임지지않습니다 주의사항 4 <Parameter issue> P_RESERVED 복합필드외에, 일반필드에서는 Value 값에하기의특수기호를불허합니다. :? new line & 외특수기호 특히, 주문번호필드 (P_OID) 와기타주문정보필드 (P_NOTI) 필드에는절대불허합니다 주의사항 5 < 문화상품권결제시, P_UNAME 필드설정 issue> 한국문화진흥의정책상, 문화상품권결제시결제고객의 [ 가맹점사용자 ID] 값이필수항목 입니다. 따라서 P_UNAME 필드에구매자명대신, [ 가맹점사용자 ID] 를채워넣어야합니다. (20byte 내 ) 페이지 26 / 52 Pub. Date:

27 기본적인설치방법 주의사항 6 < 가상계좌채번시 P_NOTI_URL issue> P_NOTI_URL 은입금통보시전달되는 URL로사용되는필드입니다. 입금통보외에가상계좌채번시에도 P_NOTI_URL 로결과가전송되오니, 채번시전달되는내용은무시하시기바랍니다. 자세한내용을샘플을참조하여주시기바랍니다. <INIpayMobile_Receive_sample.zip 샘플소스참조요망 > [ 부가설명 ] 가상계좌채번이란, 고객이가상계좌번호를발급받는단계를의미합니다. 입금통보란, 고객이가상계좌채번시받은계좌번호로돈을입금한단계를일컫습니다 주의사항 7 < 모바일거래결제취소 issue> 이니페이모바일 TM 은거래취소기능을지원하지않습니다. 따라서, 결제취소는별도의 Tx 모듈을설치하시어, Tx 모듈의취소기능을활용하셔야합니다. Tx 모듈이설치되어있지않은경우, 당사홈페이지 ( 의 전자결제 > 기술지원 > 기술안내 / 다운로드 에서최신버젼을다운로드받으시기바랍니다. 그외문의사항은당사기술지원팀 ( ts@inicis.com / ) 으로문의바랍니다 주의사항 8 <OUTBOUND 방화벽 issue> 한건의거래 Transaction 에있어서, 이니페이모바일 TM 과가맹점사이에는인증 / 승인요청등 의 OUTBOUND Request 가발생됩니다. 따라서, 가맹점의 PG 처리서버가하기의아이피를 대상으로 OUTBOUND 가허용되어있는지확인바랍니다. 연결대상프로토콜포트연결방향 fcmobile.inicis.com drmobile.inicis.com ksmobile.inicis.com mobilestg.inicis.com TCP 443 (https) OUTBOUND 페이지 27 / 52 Pub. Date:

28 기본적인설치방법 주의사항 9 <DNS 설정관련 issue> - 가맹점의웹서버의언어가 java인경우반드시 DNS캐쉬기능을꺼주셔야합니다. ( 단말기와웹서버에 Cache 된 DNS 정보가상이할경우, 결제실패됨 ) - JVM(JDK) 설정파일 networkaddress.cache.ttl 항목설정 (java.security) 이중화서비스이용을위해반드시필요한설정입니다 ( 설정후 WAS 재시작.) $JAVA_HOME/jre/lib/security/java.security 설정파일에 networkaddress.cache.ttl=0 설정 주의사항 9 < 인증결과수신및승인결과수신시 issue> 이니페이모바일 TM 에서전달하는파라미터를 Parsing 하여사용하실때의주의사항입니다. 당사에서는전달되는파라미터의순서를변경하거나, 추가적으로삽입할수있습니다. POST 혹은 GET 으로넘어오는데이터전체를 Array 에담아, 순서를정한채사용하지마십시오. 항시 Key & Value 의형태를유지하시기바랍니다. 나쁜예 ) <?php // 인증결과수신시 $_data = $_POST; $receivedata = array(); foreach($data as $value) { $tmp = explode( =,$value); $receivedata[] = $tmp[1]; $P_STATUS = $receivedata[0]; $P_RMESG1 = $receivedata[1]; $P_TID = $receivedata[2];.?> 순서가바뀔수있으며, 일부파라미터는 삭제될수도있음 주의사항 10 <P_NEXT_URL 의 Scheme issue> 근래에들어보안 Page 에서비보안 Page 로의 Submit 에대한제약이강화되고있습니다. 이니페이모바일 TM 은 Https Scheme 을사용한보안페이지로, 가맹점의 P_NEXT_URL 로인증결과를송신할때, P_NEXT_URL 의 Scheme 이 Http 일경우, 하기와같이경고가발생할수있습니다. 따라서, 되도록이면 Https Scheme 을사용하도록권장하며, Http 의사용에따른오류에대하여당사는책임지지않습니다. 페이지 28 / 52 Pub. Date:

29 기본적인설치방법 또한, 사설 SSL 인증서사용시, 전송이불가할수있사오니, 반드시체크바랍니다 주의사항 11 < 브라우져환경에서의쿠키허용 issue> 이니페이모바일 TM 을정상적으로사용하기위해서는사용자의브라우져에서쿠키를 허용하는상태여야합니다. Android IOS 기본권장 ( 필수 ) 기본권장 ( 필수 ) 설정 > 개인정보보호및보안 > 쿠키허용체크활성설정 > 개인정보보호및보안 > 쿠키허용체크활성설정 > Safari > 쿠키차단 > 내가방문한웹사이트에서허용설정 > Safari > 쿠키차단 > 항상허용 IOS 는버전에따라메뉴명이다를수있습니다 주의사항 12 < 인증결과수신시 Method issue> 이니페이모바일 TM 은다양한카드사및인증사와의복잡한연계시스템을구축하고있습니다. 때문에상황에따라, 인증결과송신과정에대하여 post 혹은 get 방식을선택적으로운영해야합니다. 가맹점에서는인증결과수신시, 개별파라미터에대하여 post 와 get 을모두수용할수있도록처리해야하며, 인증결과파라미터는가감되거나, 순서가변경될수있사오니, 이점유의바랍니다. ( 단, 결제확인에필요한필수파라미터는가감되지않음 ) 주의사항 13 < 네이버 / 카카오톡앱환경최적화 issue> 네이버 / 카카오앱에서는해당앱특성에따라, 당사결제창을띄울때, 새창 (_blank) 을띄울 경우, 정상적으로결제가진행되지않을수있습니다. 따라서가맹점플랫폼에서, 당사결제 창을띄울때, 새창이아닌, _self 형태로띄워주시길권장합니다 주의사항 14 < 안드로이드 /IOS 앱 USER AGENT 수정 > 신용카드결제시각카드사 ACS 페이지에서는사용자의 USER AGENT 를검증하고있습니다. ( 검증방식은카드사별상이 ) 가맹점앱에서 USER AGENT 를임의로변경하는경우, 카드사 인증실패가발생할수있으니이점유의바랍니다. 페이지 29 / 52 Pub. Date:

30 기본적인설치방법 주의사항 15 < 아이폰 3 rd party( 제 3 공급자 ) 앱브라우저결제 issue> ios 기본브라우저인 Safari 외앱브라우저 ( 다음, 네이버, 크롬, 페이스북등 ) 에서 ISP 결제진행시, ISP 앱에서인증완료후결제를진행한브라우저앱이아닌 Safari 브라우저로돌아가는이슈가있습니다. 해당브라우저앱에서결제를진행하는경우, 앱브라우저의 user-agent를확인하여 P_RESERVED에 app_scheme={ 앱스키마 :// 형태를설정하시면해당이슈가해결됩니다. (ex. 다음앱에서결제진행시 :: P_RESERVED 필드세팅 > app_scheme=daumapps://&twotrs_isp=y&block_isp=y& ) 확인된 App Scheme ( 기준 ) 다음네이버크롬페이스북카카오톡 daumapps:// naversearchapp:// googlechromes:// fb:// kakaotalk:// 주의사항 16 삼성페이연동시유의사항. - 웹 / 앱환경공통 1. 본메뉴얼결제창 Open( 주문정보전달 ) - 2 복합필드에서안내하고있는신용카드필수옵션 (twotrs_isp=y&block_isp=y ) 이정상적으로처리되어있어야합니다. 해당옵션이적용되어있지않은경우, 국민카드에대해서는비동기처리되어, 승인결과는노티로전달됩니다. 2. 삼성페이결제는안드로이드단말기의삼성페이지원단말기에서만사용가능합니다. - 앱환경연동가맹점 1. 가맹점앱에서 USER-AGENT 정보를제어하고있는경우, 삼성페이가정상적으로실행되지않을수있어, 당사에서는가맹점앱내 USER-AGENT 변경을권장하지않고있습니다. 2. 삼성페이앱스키마 ( samsungpay:// ) 에대해가맹점앱에서정상실행할수있도록구현되어있어야합니다. 해당내용과관련하여는본매뉴얼아래 ispmobile:// 에대한예제를참고하여 페이지 30 / 52 Pub. Date:

31 기본적인설치방법 samsungpay:// 스키마호출시에대한처리가앱에서지원되어야합니다. 페이지 31 / 52 Pub. Date:

32 앱환경의설치방법 ( 안드로이드 ) 2. 앱환경의설치방법 ( 안드로이드 ) 1-1. 기본적인설치방법 안드로이드어플리케이션내 WebView ( 이하 WebView) 에서이니페이모바일 TM 을구현하는경우에해당됩니다. 이니페이모바일 TM 을 WebView 내에구현하는경우, 발생할수있는 Encoding Issue 는 ( 주의사항 <UrlEncode issue> ) 를참조하셔주십시오. WebView 에서이니페이모바일 TM 을띄우는방식은앞장에서설명한 (1. 기본적인설치방법 ) 의방법과동일합니다. 이에이번장에서는 mobileisp 앱호출시주의사항, 카드사백신앱스키마호출및 미설치시, 앱스토어이동이슈 등의내용을주로다룹니다. A. mobileisp 연동방법 - 앱미설치체크로직직접구현 or 자동체크 mobileisp 앱의기본정보는하기와같습니다. Application Scheme Install Url ispmobile:// 상기 Scheme 과 Install Url 정보로구현가능한안드로이드코드는하기와같습니다. 1 WebViewClient 를상속받은클래스를구현하시고, shouldoverrideurlloading() 을호출하 십시오. private class INIP2PWebView extends WebViewClient public boolean shouldoverrideurlloading(webview view, String url) {. 2 상기 shouldoverrideurlloading() 함수내에, try{ catch{e 를통해, try 내에서는 startactivity(intent) 를구현하시고, catch Event 발생시, 앱스토어로이동할수있도록조치하시면됩니다. 하기에안내되는소스는상기방식에대한 Full-Source 입니다. ( 다음페이지 ) 페이지 32 / 52 Pub. Date:

33 앱환경의설치방법 ( 안드로이드 ) [shouldoverrideurlloading 부 ] private class INIP2PWebView extends WebViewClient public boolean shouldoverrideurlloading(webview view, String url) {... Uri uri = Uri.parse(url); Intent intent = new Intent(Intent.ACTION_VIEW, uri); try{ startactivity(intent); // 삼성카드안심클릭을위해추가 if( url.startswith("ispmobile://")) finish(); catch(activitynotfoundexception e) { //url prefix가 ispmobile 일겨우만 alert를띄움 if( url.startswith("ispmobile://")) { view.loaddata("<html><body></body></html>", "text/html", "euc-kr"); alertisp.show(); return true;... return true; 1 [ISP 앱스토어이동처리부 ] - alertisp protected void oncreate(bundle savedinstancestate) {... alertisp = new AlertDialog.Builder(PaymentView.this).setIcon(android.R.drawable.ic_dialog_alert).setTitle(" 알림 ").setmessage(" 모바일 ISP 어플리케이션이설치되어있지않습니다. \n설치를눌러진행해주십시요.\n취소를누르면결제가취소됩니다.").setpositivebutton(" 설치 ", new DialogInterface.OnClickListener() public void onclick(dialoginterface dialog, int which) { 페이지 33 / 52 Pub. Date:

34 앱환경의설치방법 ( 안드로이드 ) //ISP 설치페이지 URL paymentview.loadurl(" finish(); ).setnegativebutton(" 취소 ", new DialogInterface.OnClickListener() public void onclick(dialoginterface dialog, int which) { Toast.makeText(PaymentView.this, "(-1) 결제를 취소 하셨습니다.", Toast.LENGTH_SHORT).show(); finish(); ).create();... 3 mobileisp 가단말기에기설치되어있는경우, mobileisp 가정상구동될것이며, 4 mobileisp 가단말기에미설치되어있는경우, 설치후, 이니페이모바일 TM 을다시띄워 주시면됩니다. 23 페이지의예시 [shouldoverrideurlloading 부 ] 의 1 에대하여 true 혹은 false 를설정하는것은하기의표를참고하십시요. apprun_check 작동방식 앱미설치시, 앱스토어이동후, 결제페이지잔존여부 1 true / false 설정 Y ISP, 계좌이체앱, paypin - intent 작동 상태유지 true N or 미설정 ISP, 계좌이체앱, paypin appscheme 작동 하기그림1 과같이 Display 됨 false - [shouldoverrideurlloading 부 ] 의 1 을 true 로할경우, 이니페이모바일 TM 을띄운 WebView 는사라집니다. 따라서, app Scheme 형태로결제앱을호출할경우에는 그림 1 과같이오류페이지가 Display 되기때문에, WebView 를 remove 하는것이좋습니다. 페이지 34 / 52 Pub. Date:

35 앱환경의설치방법 ( 안드로이드 ) [ 그림 1] - [shouldoverrideurlloading 부 ] 의 1 을 false 로할경우, 이니페이모바일 TM 을띄운 WebView 는사라지지않기때문에, apprun_check=y 를통해현결제페이지가유지되는방식을사용하는것이좋습니다. 이방법을자동체크방식이라합니다. 단, apprun_check 옵션을통해설치체크로직이작동되므로, alertisp 함수는구현될필요가없습니다. apprun_check 로직에대하여상세히확인하시려면 ( 0. - 결제창 Open ( 주문정보전달 ) 복합필드 ) 를확인하여주십시오. 또한, Intent 호출에대하여예외처리를반드시체크하셔야합니다. B. mobileisp 연동방법 인증결과전송 ISP 앱에서인증과정이완료되면, 다시당사모바일결제창으로돌아와서하기의이미지와 같이 확인 버튼을클릭해야, 승인과정을시작하게됩니다. 클릭시, P_NEXT_URL 로페이지이동 ( 인증결과전송 ) 안드로이드는운영체제특성상, 현재앱이종료될경우, 이앱을실행시킨이전앱이다시 자동으로수행됩니다. (LIFO 방식 ) 따라서, ISP 앱이종료되면, 가맹점의앱은자동으로다시 페이지 35 / 52 Pub. Date:

36 앱환경의설치방법 ( 안드로이드 ) 활성화될것입니다. C. 안심클릭결제시, 카드사백신앱연동 이니페이모바일 TM 은 BC 계열을제외한, 나머지카드사의결제창을 IFrame 내에서운용하고 있습니다. 이에, 카드사에서개별적으로사용하는백신앱의경우, 가맹점앱에서도하기의 유의사항을반드시체크하셔야합니다. 1 WebView 내에서 http와 https URL, 그리고 App Url 을분기하여처리해야함. 2 shouldoverrideurlloading() 처리로직을하기와같이구현함. App Url 일경우 activity 호출 Web Url 일경우 WebView 에서 Loading 상기의유의사항을고려한샘플코드는하기와같습니다. (Kitkat 이하정상구동여부확인됨 ) private class SampleWebViewClient extends WebViewClient public boolean shouldoverrideurlloading(webview view, String url) { Log.d("<INICIS_TEST>","URL : "+url); /* * URL별로분기가필요합니다. 어플리케이션을로딩하는것과 * WEB PAGE를로딩하는것을분리하여처리해야합니다. * 만일가맹점특정어플 URL이들어온다면 * 조건을더추가하여처리해주십시요. */ if(!url.startswith(" &&!url.startswith(" &&!url.startswith("javascript:") ) { Intent intent; try{ intent = Intent.parseUri(url, Intent.URI_INTENT_SCHEME); Log.d("<INICIS_TEST>", "intent getdatastring : " + intent.getdatastring()); catch (URISyntaxException ex) { Log.e("<INICIS_TEST>", "URI syntax error : " + url + ":" + ex.getmessage()); return false; try{ startactivity(intent); catch(activitynotfoundexception e){ 페이지 36 / 52 Pub. Date:

37 앱환경의설치방법 ( 안드로이드 ) /* ISP어플이현재폰에없다면아래처리에서 * 알림을통해처리하도록하였습니다. * 삼성카드및기타안심클릭에서는 * 카드사웹페이지에서알아서처리하기때문에 * WEBVIEW에서는별다른처리를하지않아도처리됩니다. */ if( url.startswith("ispmobile://")) { //oncreatedialog에서정의한 ISP 어플리케이션알럿을띄워줍니다. //(ISP 어플리케이션이없을경우 ) showdialog(dialog_isp); return false; else if( url.startwith("intent://")){ //intent 형태의스키마처리 try { Intent excepintent = Intent.parseUri(url, Intent.URI_INTENT_SCHEME); String packagenm = excepintent.getpackage(); Log.d("<INIPAYMOBILE>", "excepintent getpackage : " + packagenm ); excepintent = new Intent(Intent.ACTION_VIEW); excepintent.setdata(uri.parse("market://search?q="+packagenm)); startactivity(excepintent); catch (URISyntaxException e1) { Log.e("<INIPAYMOBILE>", "INTENT:// 인입될시예외처리오류 : " + e1 ); else { view.loadurl(url); return false; return true; 페이지 37 / 52 Pub. Date:

38 앱환경의설치방법 ( 안드로이드 ) D. 결제금액이 30 만원이상일때의공인인증앱연동방법 만약상점에서의판매가격이 30만원이상일수있고카드로결제할경우, 사용자는공인인증서서명과정을거쳐야합니다. 안드로이드의경우, 개별카드사앱에서공인인증서서명을할수있습니다. 이에, 카드사창내에서호출하는 intent 혹은 app Scheme 를허용할수있도록가맹점앱에서처리해줘야합니다. 이는 (3.B. 안심클릭결제시, 카드사백신앱연동 ) 의코드를반영하면해결됩니다. E. Android API Level 21 이상일때, 체크사항 Android API Level 21 (Lollipop 출시때배포 ) 부터는 webview 에서 Insecurity Page 에대한 Access 및 Mixed contents, Third party cookies 사용을차단할수있게업데이트되었습니다. 먼저, Insecurity Page 에대한 Access 차단으로 P_NEXT_URL 의 Scheme 을 Http 로하는경우, 페이지가호출되지않아인증결과가전달되지않을수있습니다. 하기의설정을확인하십시오. 상 태 코드 Insecurity 페이지차단 WebSettings web = paymentview.getsettings(); web.setmixedcontentmode(web.mixed_content_never_allow); Insecurity 페이지허용 WebSettings web = paymentview.getsettings(); web.setmixedcontentmode(web.mixed_content_always_allow); P_NEXT_URL 의 Scheme 이 Http 일경우, 반드시 Insecurity 페이지허용 으로설정되어야 합니다. 또한, Third party cookies 사용의차단으로안심클릭카드결제시, 보안키보드를불러오지 못하는이슈등이발생할수있으니하기설정을확인하십시오. 상 태 코드 CookieManager cookiemanager = CookieManager.getInstance(); Third party cookies 허용 cookiemanager.setacceptcookie(true); cookiemanager.setacceptthirdpartycookies(samplewebview, true); // false 설정시오류발생 페이지 38 / 52 Pub. Date:

39 앱환경의설치방법 (IOS) 3. 앱환경의설치방법 (IOS) 1-1. 기본적인설치방법 IOS 어플리케이션내 WebView ( 이하 WebView) 에서이니페이모바일 TM 을구현하는경우에해당됩니다. 이니페이모바일 TM 을 WebView 내에구현하는경우, 발생할수있는 Encoding Issue 는 ( 주의사항 <UrlEncode issue> ) 를참조하셔주십시오. WebView 에서이니페이모바일 TM 을띄우는방식은앞장에서설명한 (1. 기본적인설치방법 ) 의방법과동일합니다. 이에이번장에서는 mobileisp 앱호출시주의사항, 카드사백신앱스키마호출및 미설치시, 앱스토어이동이슈 등의내용을주로다룹니다. A. mobileisp 연동방법 mobileisp 앱이종료된뒤, 가맹점앱을다시띄우기위한조치사항을안내합니다. IOS 는 Android 계열과다르게도 mobileisp 이종료된뒤, 가맹점앱은 Background 에머문채, 바탕화면이개제됩니다. (IOS의운영체제특성에기반 ) 이때문에, mobileisp 앱이종료되면서, 가맹점 appscheme 을호출하도록구성해야합니다. 하기와같이셋팅시, 요구사항과같이가맹점앱이다시기동됩니다. P_RESERVED &app_scheme= 가맹점스키마명 :// P_RESERVED 옵션에대한설명은 (1-3. 결제창 Open ( 주문정보전달 ) - 2복합필드 ) 를참조부탁드립니다. 더불어상기옵션셋팅시, 가맹점스키마명뒤 :// 은필수로입력해주셔야 mobileisp 앱종료후가맹점앱이호출됩니다. (Ex. 가맹점스키마명이 INIpayMobile일경우 app_scheme=inipaymobile:// 로셋팅해주시면됩니다.) B. 안심클릭결제시, 카드사백신앱연동 IOS 환경에서는카드사에서별도로백신을구동하지않습니다. 따라서, 해당부분은체크하실부분이없습니다. C. 카드사앱연동방법 안심클릭결제진행에필요한 Application ( 앱카드등의 ) 호출이필요할경우아래샘플코드 를참고바랍니다. 주문정보 ( 결제창 Open ( 주문정보전달 ) 복합필드 ) 내참조 페이지 39 / 52 Pub. Date:

40 앱환경의설치방법 (IOS) 앱내소스 하기샘플참조 #pragma mark UIWebViewDelegate -(BOOL)webView:(UIWebView *)webview shouldstartloadwithrequest:(nsurlrequest *)request navigationtype:(uiwebviewnavigationtype)navigationtype { // 쿠키강제허용 NSHTTPCookieStorage *cookiesto = [NSHTTPCookieStorage sharedhttpcookiestorage]; [cookiesto setcookieacceptpolicy:nshttpcookieacceptpolicyalways]; // 이니시스를통해전달되는 URL NSString *URLString = [NSString stringwithstring:[request.url absolutestring]]; //URL 을읽어왔을때애플스토어주소인경우사파리에해당 URL 을넘겨서앱스토어에서설치할수있도록유도 BOOL isstoreurl = ([URLString rangeofstring:@"phobos.apple.com" options:nscaseinsensitivesearch].location!= NSNotFound); BOOL isstoreurl2 = ([URLString rangeofstring:@"itunes.apple.com" options:nscaseinsensitivesearch].location!= NSNotFound); // 앱스토어이동 if (isstoreurl isstoreurl2) { [[UIApplication sharedapplication]openurl:request.url]; return NO; else if([urlstring hasprefix:@"http"] [URLString hasprefix:@"https"] [URLString hasprefix:@"about"] ) // 일반적인웹 url 형태인경우진행 { return YES; else{ // 그외의값은앱스키마로간주하여앱호출 NSURL *appurl = [NSURL URLWithString:URLString]; //NSString to NSURL // 앱스키마인경우앱호출 페이지 40 / 52 Pub. Date:

41 앱환경의설치방법 (IOS) BOOL bappscheme = [[UIApplication sharedapplication] canopenurl:appurl]; if (!bappscheme) { // 앱이설치되지않은경우앱스토어로이동또는안내얼럿표출 return NO; return YES; 해당샘플은참고용으로각가맹점앱에맞게구현하시면됩니다. 또한, 하기의조건을충족하는경우에결제가가능하오니, 이점유의바랍니다. 1 고객단말기의 OS 버전이 4.x 이상인경우 2 가맹점 Application 이 Multi switching 이지원되는경우 3 OS 버전이 9.x 이상일경우하기 1-6. IOS9 Application 구현시, 확인사항 내용을참고바랍니다. D. 쿠키설정 이니페이모바일 TM 을 IOS WebView 에서호출하고, 안심클릭계열서비스를사용하는경우, 세션만료오류경고가발생할수있습니다. 이에, 하기의샘플과같이쿠키를허용해야합니다. (BOOL)application:(UIApplication *)application didfinishlaunchingwithoptions:(nsdictionary *)launchoptions { [[NSHTTPCookieStorage sharedhttpcookiestorage] setcookieacceptpolicy:nshttpcookieacceptpolicyalways];... return YES; 페이지 41 / 52 Pub. Date:

42 앱환경의설치방법 (IOS) E. IOS9 버전 Application 구현시, 주의사항 IOS9 업데이트이후, APP 내보안정책강화로 canopenurl 또는 openurl 함수사용시, info.plist 파일에 LSApplicationQueriesSchemes 배열을정의하여호출할 App scheme list 를 등록해주셔야합니다. (White List 등록 ) 아래는 LSApplicationQueriesSchemes 등록예시이며, 기존앱스키마에서 "://" 부분을제거 후, 등록하시면됩니다. 예시 1. XCODE info.plist <key> LSApplicationQueriesSchemes </key> <array> <string> fbapi </string> <string> fbauth2 </string> <string> fbshareextension </string> <string> fb-messenger-api </string> <string> twitter </string> <string> whatsapp </string> <string> wechat </string> <string> line </string> <string> instagram </string> <string> kakaotalk </string> <string> mqq </string> <string> vk </string> <string> mqq </string> </array> 예시2. XML info.plist 아래 MOBILETX 에서사용중인 Custom Scheme List를참고하셔서지불수단별, 필요한부분사용바랍니다. < Custom Scheme List> 지불수단 App custom scheme 페이지 42 / 52 Pub. Date:

43 앱환경의설치방법 (IOS) 신용카드 신한앱카드신한공인인증앱 ( 일반결제 ) 현대앱카드현대공인인증앱 ( 일반결제 ) 삼성앱카드삼성공인인증앱 ( 일반결제 ) 하나앱카드하나공인인증앱 ( 일반결제 ) 농협앱카드농협공인인증앱 ( 일반결제 ) 국민앱카드롯데앱카드롯데스마트페이시티앱카드 KPAY ISP PayPin PAYCO Syrup 앱카드농협앱카드 ( 올원페이 ) 씨티앱카드 ( 신규 ) LPAY 카카오페이 SSGPAY shinhan-sr-ansimclick:// smshinhanansimclick:// hdcardappcardansimclick:// smhyundaiansimclick:// mpocket.online.ansimclick:// scardcertiapp:// cloudpay:// hanaskcardmobileportal:// nhappcardansimclick:// nonghyupcardansimclick:// kb-acp:// lotteappcard:// lottesmartpay:// citispay:// kpay:// ispmobile:// paypin:// payco:// tswansimclick:// nhallonepayansimclick:// citimobileapp:// lpayapp:// kakaotalk:// shinsegaeeasypayment:// 계좌이체계좌이체 kftc-bankpay:// 페이지 43 / 52 Pub. Date:

44 케이페이연동방법 뱅크월렛 bankwallet:// 해외지불수단은련카드 uppay:// 4. 케이페이연동방법 당사간편결제서비스인케이페이는영업담당자를통해지불수단에추가할수있습니다 케이페이사용전확인사항 케이페이는승인결과를노티형식으로전송합니다. 따라서, 주문정보중에하나인 P_NOTI_URL 로결과를전송합니다. 이에, P_NOTI_URL 이인입되지않으면, 케이페이를사용할수없습니 다. 이점유의바랍니다. A. Android WebView 에서의처리 케이페이는호출시, Intent 방식으로호출됩니다. 따라서, 상기에서안내된 shouldoverrideurlloading() 을이미처리했다면, 더이상처리할것은없습니다. 또한, Intent 방식으로호출되기때문에, 케이페이가설치되지않은단말기일경우, 자동으로앱스토어로이동됩니다. 다만, 앱스토어이동및설치후에는결제단계를처음부터수행해야합니다. B. IOS WebView 에서의처리 IOS 에서는 AppScheme 형태로호출되며, 기본적인동작방식은 Android 와동일합니다. 또 한, 앱스토어이동후에결제단계를처음부터시도해야하는로직또한동일합니다. C. 케이페이바로가기옵션 P_RESERVED( 복합필드 ) 에하기의옵션을추가할경우, 다른카드리스트를 Display 하지않고, 바로케이페이를노출시킬수있습니다. 하기의스크린샷을참고하여, 사용하시기바랍니다. 페이지 44 / 52 Pub. Date:

45 케이페이연동방법 스크린샷 Key&Value 설명 d_kpay=y 케이페이설치버튼이있는결제페이지를노출합니다. d_kpay=y& d_kpay_app=y 별도의결제페이지를노출하지않고, 즉시케이페이를실행합니다. D. 케이페이승인결과수신방법 케이페이는 1 Transaction 방식으로작동됩니다. 따라서, P_NOTI_URL 을통해승인결과를비동기식으로수신받습니다. 이점유의바랍니다. 페이지 45 / 52 Pub. Date:

46 뱅크월렛연동방법 5. 뱅크월렛연동방법 뱅크월렛은계좌이체를위한간편결제서비스입니다. 기존계좌이체서비스를연동중인가 맹점에서는별도수정사항없이뱅크월렛을사용하실수있습니다. 서비스이용문의는영업 담당자를통해진행바랍니다 주의사항 현금영수증을사용하는경우계좌이체와는다르게현금영수증처리에대한별도 UI 가제공되 지않으며무조건자동발행처리됩니다 뱅크월렛결제 Flow [ 가입정보입력 ] [ 앱호출및비밀번호입력 ] [ 인증처리진행 ] [ 결제비밀번호 4 자리입력 ] [ 뱅크월렛인증처리완료 ] [ 승인요청 ] 페이지 46 / 52 Pub. Date:

47 1-3. 뱅크월렛바로가기 P_RESERVED ( 복합필드 ) 에뱅크월렛바로가기옵션을추가할경우계좌이체탭이노출되지 않고바로뱅크월렛결제페이지로이동합니다. 하기의스크린샷을참고하여사용하시기바 랍니다. ** P_RESERVED ( 복합필드 ) 의경우하나의 input에엔드 (&) 을통해추가하는형태를띕니다. 기존에 P_RESERVED 옵션을사용하고있다면구분자 & 로옵션을추가하시면됩니다. 양식예시 : <input type= hidden name= P_RESERVED value= bank_receipt=n&d_kwpy=y /> 필드명목적 Variable 부가설명 P_RESERVED 뱅크월렛 바로가기 d_kwpy=y 해당옵션사용시, 계좌이체탭을 display 하지않고바로 뱅크월렛결제페이지로이동합니다 뱅크월렛승인결과수신 뱅크월렛은계좌이체와동일하게 1 Transaction 방식으로작동됩니다. 따라서 P_NOTI_URL 을 통해승인결과를비동기식으로수신받습니다. P_NOTI_URL 로전달받은승인결과내용은별 첨문서인 INIpayMobile_Receive_API_manual 를참고하여주시기바랍니다. 페이지 47 / 52 Pub. Date:

48 삼성월렛연동방법 6. 삼성월렛연동방법 삼성월렛을사용하기위해서는영업담당자와별도의협의를필요로합니다. 또한, 삼성의스마트폰에서만결제가가능한지불수단이기때문에, 사용자의디바이스가결제불가능한단말기일경우 (UserAgent 체크 ), 결제가불가능하도록차단하고있습니다. 다만, 신규출시된삼성단말기의경우, 차단될수있으며, 이경우, 당사기술지원 으로문의바랍니다 삼성월렛사용전확인사항 케이페이는승인결과를노티형식으로전송합니다. 따라서, 주문정보중에하나인 P_NOTI_URL 로결과를전송합니다. 이에, P_NOTI_URL 이인입되지않으면, 삼성월렛이 Display 되지않습 니다. A. Android WebView 에서의처리 호출시, Intent 방식으로호출됩니다. 따라서, 상기에서안내된 shouldoverrideurlloading() 을이미처리했다면, 더이상처리할것은없습니다. 또한, Intent 방식으로호출되기때문에, 케이페이가설치되지않은단말기일경우, 자동으로앱스토어로이동됩니다. 다만, 앱스토어이동및설치후에는결제단계를처음부터수행해야합니다. B. IOS WebView 에서의처리 IOS 에서는 AppScheme 형태로호출되며, 기본적인동작방식은 Android 와동일합니다. 또 한, 앱스토어이동후에결제단계를처음부터시도해야하는로직또한동일합니다. C. 삼성월렛바로가기옵션 P_RESERVED( 복합필드 ) 에하기의옵션을추가할경우, 다른카드리스트를 Display 하지않고, 바로삼성월렛실행페이지로이동할수있습니다. 하기의스크린샷을참고하여, 사용하시기 바랍니다. 페이지 48 / 52 Pub. Date:

49 모바일신에스크로사용방법안내 스크린샷 Key&Value 설명 d_swallet=y 삼성월렛설치버튼이있는, 삼성월렛결제페이지로바로이동합니다. 7. 모바일신에스크로사용방법안내 이니페이모바일화면에서, 신에스크로서비스를호출하는옵션입니다. 구에스크로전용상점 ID 는해당옵션을이용하지않더라도에스크로로전체결제가진행됩니다. 가맹점에서거래에따라일반결제와에스크로결제의구분결제를희망하시면신에스크로로신규또는전환계약이필요합니다. ( 단, 일부호스팅가맹점은신에스크로설정에, 제한이있을수있음 ) 또한모바일에서구매자의구매결정화면을구성하기희망하시면별도의 INIpay Mobile 에스크로구매결정매뉴얼 을참조하여주시기바랍니다. 에스크로계약에문의가있거나 자세한사항은계약담당자에게문의하여주시기바랍니다 모바일신에스크로사용가능지불수단 신용카드 계좌이체 가상계좌 A. 설정방법 매뉴얼결제창 Open ( 주문정보전달 ) 복합필드섹션을보면, P_RESERVED 파라미터항목이있습니다. 참고하시어, 동일하게상위의옵션을설정하시면됩니다. 예 ) <INPUT type= hidden name= P_RESERVED value= useescrow=y /> 페이지 49 / 52 Pub. Date:

50 부록 8. 부록 1-1. 카드사 ( 매입사 ) 코드 코 드 카드사명 코 드 카드사명 01 외환 03 롯데 04 현대 06 국민 11 BC 12 삼성 14 신한 15 한미 16 NH 17 하나 SK 21 해외비자 22 해외마스터 23 JCB 24 해외아멕스 25 해외다이너스 1-2. 카드발급사 ( 은행사 ) 코드 코드카드사명코드카드사명 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 상호저축은행 53 한국씨티은행 54 홍콩상하이은행 페이지 50 / 52 Pub. Date:

51 부록 55 도이치은행 56 ABN 암로 57 JP 모건 59 미쓰비시도쿄은행 60 BOA(Bank of America) 64 산림조합 70 신안상호저축은행 71 우체국 81 하나은행 83 평화은행 87 신세계 88 신한 ( 통합 ) 은행 97 카카오머니 98 페이코 ( 포인트 100% 사용 ) 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 증권 1-3. 이니시스카드코드 코 드 카드사명 코 드 카드사명 01 외환 03 롯데 04 현대 06 국민 11 비씨 12 삼성 14 신한 ( 구.LG카드포함 ) 21 해외 VISA 22 해외 MASTER 23 해외 JCB 페이지 51 / 52 Pub. Date:

52 부록 26 중국은련 32 광주 33 전북 34 하나 35 산업카드 41 NH 43 씨티 44 우리 48 신협체크 51 수협 52 제주 54 MG새마을금고체크 55 케이뱅크 56 카카오뱅크 71 우체국체크 95 저축은행체크 페이지 52 / 52 Pub. Date: