INIpay Mobile WEB Manual V.4.32

User Manual: Pdf
Open the PDF directly: View PDF .
Page Count: 52
Download
Open PDF In Browser	View PDF
버전 정보

INIpayMobile WEB 연동매뉴얼

INIpayMobile WEB 연동매뉴얼
SETUP GUIDE

㈜ KG 이니시스

페이지 1 / 52

Pub. Date: 2015. 01

저작권

INIpayMobile WEB 연동매뉴얼

© Copyright © 2010 KG INICIS Co, Ltd. All rights reserved.
본

문서와

정보는

(주)이니시스의

재산입니다.

또한,

모든

정보는

(주)이니시스

소유

정보이며,(주)이니시스의 사전 동의 없이 본 문서의 어떤 정보도 열람, 복사, 유용, 배포 또는
타인과 공유되어서는 안됩니다. 본 문서의 정보는 변경될 수 있으며 변경 시, 본 문서는 수정될
것입니다. 본 문서의 내용에 관한 어떠한 의견이라도 귀하의 프로젝트 또는 사업 담당자에게
전달하여 주십시오.
File:

INIpayMobile_WEB_manual.doc

Title:

INIpayMobile WEB 연동 매뉴얼

Author:

플랫폼개발팀

Version:

4.32

이 연동모듈은 모바일 환경에 최적화된 연동모듈입니다.
이 모듈을 이용한 PC 거래 구현 및 PC 기반 테스트 으로 인한 기술지원은 불가능 하며,
거래손실 및 오류에 대하여는 당사에서 책임지지 않습니다.

페이지 2 / 52

Pub. Date: 2015. 01

목차

INIpayMobile WEB 연동매뉴얼

작성일

수정 내용

2015-01-28

Initialize Version

2015-10-05

IOS9 업데이트 관련 3.앱 환경의 설치방법(IOS) 내용
추가

2015-10-15

수정이력 표 추가

작성자

문서 버전

정기수
오수민

V4.03

이현욱

V4.04

오수민

V4.05

이현욱

V4.06

오수민

V4.07

오수민

V4.08

김재호

V4.09

이현욱

V4.10

옵션 내용 추가
1) 일반 필드 추가
- P_QUOTABASE : 신용카드 할부기간 지정
- P_VBANK_TM : 가상계좌 입금기한 시간 설정
- P_CHARSET : 인증, 승인결과 받을 캐릭터셋 설정

2) P_RESERVED 옵션 추가
2015-11-06

- below1000 : 1000 원 미만 결제 허용
- d_card, d_quota : 신용카드 결제창 직접 호출
- app_scheme : 가맹점 App Scheme 설정
- extension_enable : 3rd party 기능 활성화
- hpp_corp : 통신사 선택
- merc_noint, noint_quota : 상점 무이자

3) 부록 – 이니시스 카드 코드 추가
2015-11-26

3. 앱 환경의 설치방법(IOS)
- 안심클릭 공인인증 App custom scheme 내용 추가

2016-02-11

은행사 코드 업데이트

2016-03-22

P_RESERVED 옵션의 app_scheme 값에 대한 부연 설명
추가

2016-05-26

IOS 시티 앱카드 스키마 추가

2016-06-14

IOS9 버전 Application 구현 시, 주의 사항 내용 추가
-

PAYCO Scheme 추가

2016-08-02

유의사항 14 ( 앱 USER AGENT ) 주의사항 내용 추가

김재호

V4.11

2016-09-19

안드로이드 / IOS( IOS10 대응) 코드 수정

김재호

V4.12

2016-09-26

syrup 앱카드 스키마 추가

김재호

V4.13

2016-10-04

뱅크월렛 내용 추가

오수민

V4.14

페이지 3 / 52

Pub. Date: 2015. 01

목차

INIpayMobile WEB 연동매뉴얼

1) P_RESERVED 옵션 추가
- d_kwpy : 뱅크월렛 결제 페이지 바로 가기

2) 뱅크월렛 앱 스키마 추가
- bankwallet://
뱅크월렛 내용 추가
2016-10-07

- 5 번 목차 추가 : 뱅크월렛 연동방법

오수민

V4.15

김재호

V4.16

(현금영수증 처리, 승인결과 수신 등)
2016-10-21

P_SRC_CODE 페이코 추가
3rd party 앱브라우저 결제 이슈 내용 추가

2016-10-27

아웃바운드 IP 추가

오수민

V4.17

2016-11-22

농협 올원페이 앱스키마 추가

김재호

V4.18

2016-12-19

씨티카드 신규 앱스키마 추가

김재호

V4.19

김재호

V4.20

2016-12-27

휴대폰 결제 승인 결과 이통사정보 수정
(P_HPP_CORP 응답 값 변경)

2016-12-31

카카오톡 최적화 이슈 및 iOS third-party 스키마추가

김재호

V4.21

2017-03-31

삼성페이 연동 시 유의사항 추가

김재호

V4.22

김재호

V4.23

2017-06-19

LPAY 앱스키마 추가,
LPAY app_scheme 옵션 지원 지불수단 추가

2017-06-29

페이코 app_scheme 옵션 지원 지불수단 추가

김재호

V4.24

2017-08-02

하나카드 공인인증 앱 스키마 추가

오수민

V4.25

2017-08-18

카드 코드 추가(페이코, 카카오뱅크)

김재호

V4.26

오수민

V4.27

김재호

V4.28

오수민

V4.29

김재호

V4.30

오수민

V4.31

페이코 (포인트 100% 사용) 발급사 수정
2017-08-23

- 이니시스 카드코드 98 에 기입되어 있던
페이코(포인트 100%사용)을 발급사로 이동

2017-09-08
2017-10-20
2017-11-22
2017-11-30

페이지 4 / 52

2trs 결제 현금영수증 승인정보 추가
카카오페이 스키마 추가 (kakaotalk://)
카카오 머니 발급사 코드 (97) 추가
OUTBOUND 방화벽 도메인정보추가
SSGPAY 스키마 추가 (shinsegaeeasypayment://)
승인 결과 내 P_SRC_CODE 삼성페이(B), LPAY(L),

Pub. Date: 2015. 01

목차

INIpayMobile WEB 연동매뉴얼

SSGPAY(G), 카카오페이(O) 추가
2017-12-19

페이지 5 / 52

카드 코드 추가(케이뱅크)

오수민

V4.32

Pub. Date: 2015. 01

목차

INIpayMobile WEB 연동매뉴얼

목
1.

2.

차

기본적인 설치 방법 .......................................................................................................................................................... 8
1-1.

연동 Flow ............................................................................................................................................................... 8

1-2.

1 접속 주소 및 일반필드........................................................... 9
결제창 Open (주문정보 전달) – ○

1-3.

2 복합필드 ...................................................................................... 12
결제창 Open (주문정보 전달) – ○

1-4.

1 2 Transaction 방식의 구성 .............................................................. 17
결제페이지 구성 예제 - ○

1-5.

2 1 Transaction 방식의 구성 .............................................................. 17
결제페이지 구성 예제 - ○

1-6.

인증결과수신 (only 2 Transaction) .......................................................................................................... 18

1-7.

승인요청 송신 및 승인처리결과 수신 (only 2 Transaction) ....................................................... 19

1-8.

승인결과 수신필드 상

1-9.

“가상계좌 방식”과 “계좌이체 방식” 상

1-10.

1 Transaction 방식에서 결제 완료 후 결과 수신............................................................................ 25

1-11.

P_NOTI_URL 수신 후, 처리방법 ............................................................................................................... 25

1-12.

1  ....................................................................................................... 26
주의사항 ○

1-13.

2  .............................................................................................................. 26
주의사항 ○

1-14.

3  ..................................................................................................................... 26
주의사항 ○

1-15.

4 <Parameter issue> .............................................................................................................. 26
주의사항 ○

1-16.

5 <문화상품권 결제 시, P_UNAME 필드 설정 issue> .......................................... 26
주의사항 ○

1-17.

6 <가상계좌 채번시 P_NOTI_URL
주의사항 ○

1-18.

7 <모바일 거래 결제취소 issue> .................................................................................... 27
주의사항 ○

1-19.

8 <OUTBOUND 방화벽 issue>......................................................................................... 27
주의사항 ○

1-20.

주의사항 ○
9 <DNS 설정관련 issue> .................................................................................................... 28

1-21.

주의사항 ○
9 <인증결과 수신 및 승인결과 수신시 issue> ........................................................ 28

1-22.

10 <P_NEXT_URL 의 Scheme issue> ............................................................................... 28
주의사항 ○

1-23.

11 <브라우져 환경에서의 쿠키허용 issue> .................................................................. 29
주의사항 ○

1-24.

12 <인증결과 수신시 Method issue>.............................................................................. 29
주의사항 ○

1-25.

13 <네이버/카카오톡 앱 환경 최적화 issue> ............................................................. 29
주의사항 ○

1-26.

14 <안드로이드/IOS 앱 USER AGENT 수정> ............................................................... 29
주의사항 ○

1-27.

15 <아이폰 3rd party(제3 공급자) 앱브라우저 결제 issue> ................................. 30
주의사항 ○

1-28.

16
주의사항 ○

(only 2 Transaction) ................................................................................... 21
안내 .................................................................................. 24

issue> .................................................................. 27

삼성페이 연동 시 유의사항. ........................................................................................ 30

앱 환경의 설치방법(안드로이드) ............................................................................................................................. 32
1-1.

기본적인 설치방법 .......................................................................................................................................... 32

A.

mobileISP 연동방법 - 앱 미설치 체크로직 직접구현 or 자동체크 ....................................... 32

B.

mobileISP 연동방법 – 인증결과 전송................................................................................................... 35

C.

안심클릭 결제 시, 카드사 백신 앱 연동 ............................................................................................. 36

D.

결제 금액이 30만원 이상일 때의 공인인증 앱 연동 방법 ........................................................ 38

E.

Android API Level 21 이상 일 때, 체크사항 ...................................................................................... 38

페이지 6 / 52

Pub. Date: 2015. 01

목차

3.

4.

5.

6.

7.

8.

INIpayMobile WEB 연동매뉴얼

앱 환경의 설치방법(IOS) ............................................................................................................................................. 39
1-1.

기본적인 설치방법 .......................................................................................................................................... 39

A.

mobileISP 연동방법 ........................................................................................................................................ 39

B.

안심클릭 결제 시, 카드사 백신 앱 연동 ............................................................................................. 39

C.

카드사 앱 연동 방법 ..................................................................................................................................... 39

D.

쿠키 설정 ............................................................................................................................................................ 41

E.

IOS9버전 Application 구현 시, 주의 사항 ......................................................................................... 42

케이페이 연동방법.......................................................................................................................................................... 44
1-1.

케이페이 사용 전 확인사항 ....................................................................................................................... 44

A.

Android WebView 에서의 처리................................................................................................................ 44

B.

IOS WebView 에서의 처리 ......................................................................................................................... 44

C.

케이페이 바로가기 옵션 .............................................................................................................................. 44

D.

케이페이 승인결과 수신방법 ..................................................................................................................... 45

뱅크월렛 연동방법.......................................................................................................................................................... 46
1-1.

주의사항 ............................................................................................................................................................... 46

1-2.

뱅크월렛 결제 Flow ....................................................................................................................................... 46

1-3.

뱅크월렛 바로가기 .......................................................................................................................................... 47

1-4.

뱅크월렛 승인결과 수신 .............................................................................................................................. 47

삼성월렛 연동방법.......................................................................................................................................................... 48
1-5.

삼성월렛 사용 전 확인사항 ....................................................................................................................... 48

A.

Android WebView 에서의 처리................................................................................................................ 48

B.

IOS WebView 에서의 처리 ......................................................................................................................... 48

C.

삼성월렛 바로가기 옵션 .............................................................................................................................. 48

모바일 신에스크로 사용방법 안내 ......................................................................................................................... 49
1-1.

모바일 신 에스크로 사용가능 지불수단 .............................................................................................. 49

A.

설정 방법 ............................................................................................................................................................ 49

부록 ........................................................................................................................................................................................ 50
1-1.

카드사(매입사) 코드 ....................................................................................................................................... 50

1-2.

카드 발급사(은행사) 코드............................................................................................................................ 50

1-3.

이니시스 카드 코드 ........................................................................................................................................ 51

페이지 7 / 52

Pub. Date: 2015. 01

기본적인 설치 방법

INIpayMobile WEB 연동매뉴얼

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 결제결과 출력
○

가맹점
페이지 8 / 52

구매자

이니페이모바일TM
Pub. Date: 2015. 01

기본적인 설치 방법

1-2.

INIpayMobile WEB 연동매뉴얼

1 접속 주소 및 일반필드
결제창 Open (주문정보 전달) – ○

주문정보 전달이란, 하기의 Step 을 의미합니다.
1 결제페이지 요청 (주문정보 인입)
○
2 결제페이지 노출
○
3 결제정보입력 및 인증요청
○
4 인증결과 전송
○
5 승인요청 (Http-Socket Back 단 요청)
○
6 승인결과 출력(Http-Socket Receive Data)
○

결과출력

가맹점

구매자

이니페이모바일TM

상점 페이지에서 이니페이모바일TM 접속 시, 지불수단별로 상이한 URL 을 사용합니다.
이에, 하기의 URL 을 참고하시기 바랍니다.

Url

신용카드

https://mobile.inicis.com/smart/wcard/

계좌이체

https://mobile.inicis.com/smart/bank/

가상계좌

https://mobile.inicis.com/smart/vbank/

휴대폰

https://mobile.inicis.com/smart/mobile/

문화상품권

https://mobile.inicis.com/smart/culture/

해피머니상품권

https://mobile.inicis.com/smart/hpmn/

스마트문상
전자지갑

https://mobile.inicis.com/smart/dgcl/
https://mobile.inicis.com/smart/ewallet/

이니페이모바일TM접속시, 결제페이지를 구성하기 위해서는 하기 Parameter를 필요로 합니다.
양식 예시 : <input type=”hidden” name=”필드명” value=”값 예시” />
필드명

목

적

부 가 설 명 및 주 의 사 항

크

기

필수여부

전 지불수단 공통 필드
P_MID

상점아이디

P_OID

주문번호

P_AMT

거래금액

P_UNAME

고객성명

P_MNAME

가맹점 이름

P_NOTI

기타주문정보

페이지 9 / 52

계약된 당사발급 아이디
한글을 제외한, 숫자/영문/특수기호의 형태
필수대상 : 가상계좌
단위 표시 기호(콤마) 를 반드시 제거 요망

Char(10)
Char(40)

필수
필수대상
외 선택

Char(8)

필수

Char(30)

필수
선택

이 값은 가맹점에서 이용하는 추가 정보

Char(800)

선택

Pub. Date: 2015. 01

기본적인 설치 방법

INIpayMobile WEB 연동매뉴얼

필드로 전달한 값이 그대로 반환됩니다.
결제처리 시, 꼭 필요한 내용만 사용하

요.

800byte 를 초과하는 P_NOTI 의 값은
차후 문제가 생길 여지가 있으니
반드시 800byte 를 초과하지 않도록
설정해야 합니다.
P_GOODS
P_MOBILE
P_EMAIL

결제상품명
구매자

‘-‘ 를 포함한 번호를 적어주

휴대폰번호

구현 예시 : 000-0000-0000

구매자
E-mail

요.

구현 예시 : abc@abc.com

Char(80)

필수

Char(15)

선택

Char(30)

선택

사용자의 인증이 완료될 때,
이 Url 로 인증결과를 전달합니다.
P_NEXT_URL

인증결과수신
Url

Method : post or get (issue : 1-24 보기)
Scheme : https (issue : 1-22 보기)

예외대상
Char(250)

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: 2015. 01

기본적인 설치 방법

INIpayMobile WEB 연동매뉴얼

구현예시 :
http://abc.com/result?goods_no=1243
영수증에 표기할 부가
P_TAX

부가

주

의 : 전체금액의 10%이하로 설정

대상 : ‘부가
P_TAXFREE

비과

과

금액

업체정함’ 설정업체에 한함

되지 않는 금액

대상 : ‘부가

선택

업체정함’ 설정업체에 한함

선택

상품의 제공기간을 설정해야 하는 경우, 사
용되는 옵션으로, 이니페이 모바일에 디스
플레이 하는 용도로만 사용됩니다.
1) 상점에서 16자리 값 입력 시
(2013012920130229): 날짜 표시 Ex.
2013.01.29 ~ 2013.02.29
2) 상점에서 24자리 값 입력 시
P_OFFER_PE
RIOD

제공기간

(201301291130201302291230): 날짜시간표
시 Ex. 2013.01.29 11:30 ~ 2013.02.29 12: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

할부기간 지정

페이지 11 / 52

(36 개월 MAX)
Ex. 01:02:03:04.. 01 은 일시불, 02 는 2 개월

선택

등등

Pub. Date: 2015. 01

기본적인 설치 방법

INIpayMobile WEB 연동매뉴얼

휴대폰 전용 필드
P_HPP_METH

실물여부

OD

구분

컨텐츠 일 경우 : 1

휴대폰결제

실물일 경우 : 2

필수

컨텐츠/실물 여부는 계약담당자에게 확인요
가상계좌 전용 필드

P_VBANK_DT

입금기한 날짜

P_VBANK_T
M

설정을 하지 않으면,

가상계좌

가상계좌

요청일 + 10 일로 자동설정 됩니다.

선택

Ex. 20151225
시분까지 설정 가능합니다. (4 자리)

입금기한 시간

선택

Ex. 2030
기타 옵션 필드
인증, 승인결과 CHARSET 정의
default 는 euc-kr 이며, 인증·승인 결과를

P_CHARSET

캐릭터셋 설정

utf-8 로 받기를 원하시면 해당 옵션 설정

선택

값을 utf8 로 하시면 됩니다.
Ex. utf8

1-3.

2 복합필드
결제창 Open (주문정보 전달) – ○

이번 장에서 안내하는 복합필드는 하나의 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: 2015. 01

기본적인 설치 방법

INIpayMobile WEB 연동매뉴얼

신용카드에 한하며,
카드포인트
사용여부

cp_yn=Y

신용카드 포인트를 사용가능하게 하는 옵션입니다.
이 옵션을 사용하면, 신용카드 사의 포인트를 사용할
수 있습니다.
카드사 창에서 호출되는 백신앱 및 앱카드를 제외한,
이니페이모바일 TM 에서 직접 호출하는 앱(ISP 등)의

앱 호출시,
Intent 형식
으로

호출방식을 Intent 방식으로 작동시키며, 설치유무
apprun_check=Y

체크를 이니페이모바일 TM 에서 직접 컨트롤 하는
기능을 수행합니다. (Chrome, safari, ff)

호출여부

* 해당 기능은 Android 단말기에서만 정상 동작하며,
app_scheme 옵션과 같이 사용할 수 없습니다.
Android

30 만원 이상
결제시

신 에스크로
사용여부
1000 원 미만
결제 허용

ismart_use_sign
=Y

useescrow=Y

이 옵션 필요 없음(해당없음)
웹형태

IOS

앱형태

ismart_use_sign=Y
ismart_use_sign=Y&
mall_app_name=가맹점스키마

“신에스크로 약관동의” 와 “구매자 본인확인”
페이지가 포함된 신에스크로 결제창을 호출 합니다.
신용카드 거래 시, 1000 원 미만 결제를 허용하는

below1000=Y

옵션 입니다.
옵션을 사용하지 않으면, 자동 미사용 됩니다.
신용카드 결제창(안심클릭 / ISP)을 직접 호출하는

신용카드
결제창 직접
호출

d_card=00(코드)

옵션 입니다.

d_quota=00(할

설정 방법 : d_card=00(카드코드)

부개월)

d_quota=00(할부개월)
Ex. d_card=04&d_quota=03
가맹점 APP 및 타사 앱을 통해 결제 진행 시 아래

가맹점 App

app_scheme=스

scheme 설정

키마 값

지불수단을 사용할 경우 설정(IOS 지원)
ISP 2trs, 뱅크월렛, 은련카드, LPAY, 페이코
Ex. app_scheme=스키마명://
(스키마명 뒤에 :// 는 꼭 입력해주셔야 합니다.)
휴대폰결제 업체(SKT, KTF, LGT)를 지정할 수 있는

통신사 선택

hpp_corp=통신

옵션 입니다.

사

Ex. SKT 만 사용 – hpp_corp=SKT
SKT, KTF 사용 - hpp_corp=SKT:KTF
무이자 이벤트 진행 시, 상점 부담 무이자 옵션
입니다. (대표 무이자 및 분담 무이자 아님)

신용카드
상점무이자

merc_noint=Y
noint_quota=00
-00(카드-개월)

설정 방법 : merc_noint = Y
noint_quota=00-00:00(카드-개월:개월)
** [카드-월:월]^ 카드는 OO 두자리, 할부개월 01→1
** 카드 추가 시, 구분자는 ^ 입니다.
** 잘못된 예 11-02:04:06

페이지 13 / 52

Pub. Date: 2015. 01

기본적인 설치 방법

INIpayMobile WEB 연동매뉴얼

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: 2015. 01

기본적인 설치 방법

INIpayMobile WEB 연동매뉴얼

(이어서…)
<apprun_check=Y 사용시> - ISP 앱이 없다면, 앱 스토어 이동 및 설치 후, 결제를 이어서 진
행할 수 있습니다.
Step1) 약관동의

Step2) 카드선택

상동

상동

Step3) ISP 결제 시작

Step4) ISP 없을 때

Step5) 앱 설치 후

페이지 15 / 52

Pub. Date: 2015. 01

기본적인 설치 방법

페이지 16 / 52

INIpayMobile WEB 연동매뉴얼

Pub. Date: 2015. 01

기본적인 설치 방법

1-4.

INIpayMobile WEB 연동매뉴얼

1 2 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=”5124213” />
<input type=”hidden” name=”P_EMAIL” value=”abc@abc.com” />
<input type=”hidden” name=”P_UNAME” value=”구매자명” />
<input type=”hidden” name=”P_NEXT_URL” value=”https://가맹점 Next_Url” />
<input type=”button” onclick=”formSubmit();” />
</form>

1-5.

2 1 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=”5124213” />
<input type=”hidden” name=”P_EMAIL” value=”abc@abc.com” />
<input type=”hidden” name=”P_UNAME” value=”구매자명” />
<input type=”hidden” name=”P_NOTI_URL” value=”https://가맹점 Noti_Url” />
<input type=”hidden” name=”P_RETURN_URL” value=”https://가맹점 Return_Url” />
<input type=”button” onclick=”formSubmit();” />
</form>

페이지 17 / 52

Pub. Date: 2015. 01

기본적인 설치 방법

1-6.

INIpayMobile WEB 연동매뉴얼

인증결과수신 (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

인증상태

P_RMESG1

결과메시지

P_TID

인증거래번호

비

고

성공시 00, 그 외 실패

Char(40) / 성공시에만 반환
가맹점에서 이니페이모바일로 승인요청을 할 때, 사용되는 Url

P_REQ_URL

승인요청 Url

입니다. 거래 건 마다 상이한 URL 이 전달됩니다.
따라서, 절대 고정하여 사용하지 마십시오.
Http Scheme 은 https 를 사용합니다.
최초 거래시 주문정보에 P_NOTI 를 설정하셨다면, 그 값을 전

P_NOTI

기타주문정보

달받을 수 있습니다. 이 값은 P_NOTI 값을 그대로 리턴합니
다.

※ 뱅크월렛 지불수단의 경우, 상기의 인증결과 값이 아닌, (1-8. 승인결과 수신필드 상
(only 2 Transaction) 의 값이 전달됩니다. 이점 유의 바랍니다.
페이지 18 / 52

Pub. Date: 2015. 01

기본적인 설치 방법

INIpayMobile WEB 연동매뉴얼

또한, 당사에서 인증결과 송신시 사용하는 Method 는 post, get 을 선택적으로 사용하오니,
두가지 방식을 모두 수용할 수 있도록 처리 바랍니다.

1-7.

승인요청 송신 및 승인처리결과 수신 (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 : 이니시스

현재 URL : P_NEXT_URL

현재 URL : P_NEXT_URL

이니페이 모바일TM에서

인증결과 수신 후,

이니시스 인증결과 수신

P_NEXT_URL 로

P_REQ_URL 호출

및 승인처리 후

인증결과 송신

(Http-Socket)

결과 출력

현재 URL : P_NEXT_URL
파란색 : 이니페이모바일TM, 붉은색 : 가맹점

상점에서 호출한
Socket 의 Receive-Data로
출력된 결과 수신

승인요청 시, 사용하는 통신 규격은 하기와 같습니다.

페이지 19 / 52

Pub. Date: 2015. 01

기본적인 설치 방법

INIpayMobile WEB 연동매뉴얼

통신수단

Http-Socket

통신방식

post

승인요청 시, 하기의 필드를 반드시 첨부하셔야 합니다.
필드명

목

적

P_TID

인증거래번호

P_MID

상점아이디

비

고

인증결과 수신시, 포함된 인증거래번호(P_TID)
거래 시 사용된, 당사발급 아이디

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: 2015. 01

기본적인 설치 방법

1-8.

INIpayMobile WEB 연동매뉴얼

승인결과 수신필드 상세 (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

P_NOTI

주문정보

P_NOTEURL
P_NEXT_URL
페이지 21 / 52

char(500)
지불 결과 메시지
char(800)
주문정보에 입력한 값 반환

가맹점 전달

거래요청 시 입력한 값을 그대로

NOTI URL

반환합니다.

가맹점 전달

거래요청 시 입력한 값을 그대로

NEXT URL

반환합니다.
Pub. Date: 2015. 01

기본적인 설치 방법

신용카드
U 포인트

P_CARD_NUM
P_CARD_ISSUER_CO
DE
P_CARD_MEMBER_N
UM
P_CARD_PURCHASE_
CODE

신용카드

전자지갑

카드번호
발급사 코드
가맹점번호
매입사 코드

계약관계에 따라 틀림
char(2)
자체 가맹점 일 경우만 해당
자체 가맹점 일 경우만 해당

P_CARD_PRTC_COD

부분취소

부분취소가능 : 1 , 부분취소불가능 :

E

가능여부

0

P_CARD_INTEREST

무이자 할부여부

0 : 일반, 1 : 무이자

P_CARD_CHECKFLA
G

휴대폰

INIpayMobile WEB 연동매뉴얼

0 : 신용카드,
체크카드 여부

1 : 체크카드
2 : 기프트카드
char(500)

P_RMESG2

메시지 2

P_FN_CD1

카드코드

P_AUTH_NO

승인번호

P_ISP_CARDCODE

VP 카드코드

P_FN_NM

결제카드한글명

BC카드,

P_EVENT_CODE

이벤트코드

A1,A2 등등

휴대폰

char(3)

통신사

***

P_HPP_CORP
P_HPP_NUM

결제 휴대폰 번호

P_EWALLET_TYPE

전자지갑 종류

신용카드 할부 개월 수
char(4)
char(30)
신용카드거래에서만 사용합니다

YPAY : 옐로페이
KWPY : 뱅크월렛
P : 페이핀
K : 국민앱카드

앱연동
결제구분

C: 페이코
P_SRC_CODE

앱연동여부

B: 삼성페이
L: LPAY
O: 카카오페이
G: SSGPAY

현금
영수증

페이지 22 / 52

P_CSHR_CODE

처리상태

P_CSHR_MSG

처리메시지

P_CSHR_AMT

220000 : 정상, 그 외 : 오류

현금영수증

총금액 =

총 금액

공급가액+ 금+봉사료
Pub. Date: 2015. 01

기본적인 설치 방법

P_CSHR_SUP_AMT
P_CSHR_TAX

INIpayMobile WEB 연동매뉴얼

공급가액
금

P_CSHR_SRVC_AMT

봉사료

P_CSHR_TYPE

용도구분

P_CSHR_DT

발행시간

0:소득공제용, 1:지출증빙용
가상계좌의 경우,

P_CSHR_AUTH_NO

발행번호

입금 완료 시, 생성되어 모바일 내
채번시에는 전달되지 않습니다.

페이지 23 / 52

Pub. Date: 2015. 01

기본적인 설치 방법

1-9.

INIpayMobile WEB 연동매뉴얼

“가상계좌 방식”과 “계좌이체 방식” 상세안내

“가상계좌 방식” 과 “계좌이체 방식” 은 입금 통보 등의 과정을 필요로 하기 때문에, 상기에
안내한 방식과 다소 다른 점이 있습니다. 하기에는 가상계좌와 계좌이체에서 각기 사용하는
“인증완료 후, 이동페이지” 와, “입금통보 혹은 승인완료 통보” 방식에 대하여 안내합니다.
인증완료 후 이동 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: 2015. 01

기본적인 설치 방법

INIpayMobile WEB 연동매뉴얼

계좌이체 Flow 는 하기와 같습니다.
<<계좌이체 Flow>>
1 결제페이지 요청 (주문정보 인입)
○
2 결제페이지 노출
○
3 결제정보입력 및 인증요청
○
4 P_RETURN_URL 로 이동
○

별도
트랜

노티

4 입금 확인 시, 결과전송(Http-Socket Back 단 전송)
○

잭션

방식

5 노티 정상수신 출력(Http-Socket Receive Data)
○
6 결제완료 확인
○
7 결제결과 출력
○

가맹점

구매자

이니페이모바일TM

상기에 안내한 바와 같이, 가상계좌 방식과 계좌이체 방식, 그리고 기타 방식(신용카드 등)
의 차이점이 있사오니, 이점 유의 하시기 바랍니다.

1-10.

1 Transaction 방식에서 결제 완료 후 결과 수신

P_NOTI_URL 로 전송되는 파라미터 및 값은 별첨문서인 “INIpayMobile_Receive_API_manual”
를 참고하여 주시기 바랍니다.
1 P_NOTI_URL 은 네트워크 사정에 따라 1회 이상 발생될 수 있사오니, 중복호출여부를 체
○

크하는 루틴을 반드시 구현하십시오.
2 NOTI 를 통한 결과 송신은 하기의 조건에 따라 수행됩니다.
○

24시간 이내 재전송 가능 | 24시간 이후 시퀀스 종료 | 재전송 주기 약 10분

1-11.

P_NOTI_URL 수신 후, 처리방법

당사 Back 단에서 전송된 Noti 는 하기의 조건을 충족하지 않을 경우, 재전송 루틴을 수행하
게 됩니다. 따라서, (1-10.1 Transaction 방식에서 결제 완료 후 결과 수신) 장에서 안내한 바
와 같이 중복체크 루틴을 반드시 구현하시고, 하기의 조건을 충족하여 주시기 바랍니다.
1 Noti 수신 후, P_NOTI_URL 에 OK 만 출력 요망.
○
2 대문자 OK 외 html 및 공백, 개행문자 불허
○

페이지 25 / 52

Pub. Date: 2015. 01

기본적인 설치 방법

1-12.

INIpayMobile WEB 연동매뉴얼

1 <Form Encode issue>
주의사항 ○

이니페이모바일TM 은 EUC-KR을 사용합니다. 이에, 반드시 EUC-KR 인코딩으로 전송 바랍니다.
<form method=”post” accept-charset=”euc-kr”>

1-13.

2 <UrlEncode issue>
주의사항 ○

상점 페이지에서 이니페이모바일TM로 주문정보 전송 시, Form Data 가 Double Encoded 되어
전송되는 경우가 있습니다. 하기의 Case 를 확인하시어, Encoding 여부를 체크하십시오.
가맹점

이니페이모바일 TM

Url-Encode

BASE

호출 BASE

여부

Web-Browser

Web-Browser

필요 없음

App

WebView

체크 요망

App

Web-Browser

필요 없음

urlEncode 구현 시, 필드명은 미포함 한, input 의 value 부만 encoding 해야 합니다.
예시 ) <input type=”hidden” name=”P_RESERVED” value=”urlencode(value)” />

1-14.

3 <iFrame issue>
주의사항 ○

이니페이모바일TM 을 Non-Iframe 에 최적화 되어 있습니다. 이에, iFrame 내에 구현하는 것을
권장하지 않습니다. iFrame 구현에 따른 문제에 대하여는 당사에서 책임지지 않습니다.

1-15.

4 <Parameter issue>
주의사항 ○

P_RESERVED 복합필드 외에, 일반필드에서는 Value 값에 하기의 특수기호를 불허합니다.
:

?

‘

new line

“

&

외 특수기호

특히, 주문번호필드(P_OID) 와 기타주문정보필드(P_NOTI) 필드에는 절대 불허합니다.

1-16.

5 <문화상품권 결제 시, P_UNAME 필드 설정 issue>
주의사항 ○

㈜한국문화진흥의 정책 상, 문화상품권 결제 시 결제고객의 [가맹점 사용자ID] 값이 필수항목
입니다. 따라서 P_UNAME 필드에 구매자 명 대신, [가맹점 사용자 ID]를 채워 넣어야 합니다.
(20byte내)
페이지 26 / 52

Pub. Date: 2015. 01

기본적인 설치 방법

1-17.

INIpayMobile WEB 연동매뉴얼

6 <가상계좌 채번시 P_NOTI_URL
주의사항 ○

issue>

P_NOTI_URL 은 입금 통보 시 전달되는 URL로 사용되는 필드 입니다.
입금 통보 외에 가상 계좌 채번 시에도 P_NOTI_URL 로 결과가 전송 되오니, 채번 시 전달되
는 내용은 무시 하시기 바랍니다. 자

한 내용을 샘플을 참조 하여 주시기 바랍니다.

<INIpayMobile_Receive_sample.zip 샘플소스 참조 요망>
[부가설명]
가상계좌 채번이란, 고객이 가상계좌번호를 발급 받는 단계를 의미합니다.
입금 통보 란, 고객이 가상계좌 채번 시 받은 계좌번호로 돈을 입금 한 단계를 일컫습니다.

1-18.

7 <모바일 거래 결제취소 issue>
주의사항 ○

이니페이모바일TM 은 거래취소기능을 지원하지 않습니다.
따라서, 결제 취소는 별도의 Tx 모듈을 설치하시어, Tx 모듈의 취소기능을 활용하셔야 합니다.
Tx 모듈이 설치되어 있지 않은 경우, 당사 홈페이지(www.inicis.com) 의 “전자결제 > 기술지
원 > 기술안내/다운로드” 에서 최신버젼을 다운로드 받으시기 바랍니다.
그 외 문의사항은 당사 기술지원팀 ( ts@inicis.com / 02-3430-5960 ) 으로 문의 바랍니다.

1-19.

8 <OUTBOUND 방화벽 issue>
주의사항 ○

한 건의 거래Transaction 에 있어서, 이니페이모바일TM 과 가맹점 사이에는 인증/승인요청 등
의 OUTBOUND Request 가 발생됩니다. 따라서, 가맹점의 PG 처리 서버가 하기의 아이피를
대상으로 OUTBOUND 가 허용되어 있는지 확인바랍니다.

연결대상

프로토콜

118.129.210.57

fcmobile.inicis.com

211.219.96.166

drmobile.inicis.com

183.109.71.50

ksmobile.inicis.com

118.129.210.107

mobilestg.inicis.com

TCP

포트

443 (https)

연결방향

OUTBOUND

페이지 27 / 52

Pub. Date: 2015. 01

기본적인 설치 방법

1-20.
-

INIpayMobile WEB 연동매뉴얼

주의사항 ○
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” 설정

1-21.

주의사항 ○
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];

순서가 바뀔 수 있으며, 일부 파라미터는
삭제될 수도 있음.

….
?>

1-22.

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: 2015. 01

기본적인 설치 방법

INIpayMobile WEB 연동매뉴얼

또한, 사설 SSL 인증서 사용 시, 전송이 불가할 수 있사오니, 반드시 체크 바랍니다.

1-23.

11 <브라우져 환경에서의 쿠키허용 issue>
주의사항 ○

이니페이모바일 TM 을 정상적으로 사용하기 위해서는 사용자의 브라우져에서 쿠키를
허용하는 상태여야 합니다.

Android
IOS

기본

설정 > 개인정보 보호 및 보안 > 쿠키허용 체크활성

권장(필수)

설정 > 개인정보 보호 및 보안 > 쿠키허용 체크활성

기본

설정 > Safari > 쿠키차단 > 내가 방문한 웹사이트에서 허용

권장(필수)

설정 > Safari > 쿠키차단 > 항상 허용
※

1-24.

IOS 는 버전에 따라 메뉴 명이 다를 수 있습니다.

12 <인증결과 수신시 Method issue>
주의사항 ○

이니페이모바일TM 은 다양한 카드사 및 인증사와의 복잡한 연계시스템을 구축하고 있습니다.
때문에 상황에 따라, 인증결과 송신과정에 대하여 post 혹은 get 방식을 선택적으로 운영해
야 합니다. 가맹점에서는 인증결과 수신 시, 개별 파라미터에 대하여 post 와 get 을 모두 수
용할 수 있도록 처리해야 하며, 인증결과 파라미터는 가감되거나, 순서가 변경될 수 있사오니,
이점 유의 바랍니다. (단, 결제 확인에 필요한 필수 파라미터는 가감되지 않음)

1-25.

13 <네이버/카카오톡 앱 환경 최적화 issue>
주의사항 ○

네이버/카카오 앱에서는 해당 앱 특성에 따라, 당사 결제창을 띄울 때, 새 창(_blank)을 띄울
경우, 정상적으로 결제가 진행되지 않을 수 있습니다. 따라서 가맹점 플랫폼에서, 당사 결제
창을 띄울 때, 새창이 아닌, _self 형태로 띄워주시길 권장합니다.

1-26.

14 <안드로이드/IOS 앱 USER AGENT 수정>
주의사항 ○

신용카드 결제 시 각 카드사 ACS페이지에서는 사용자의 USER AGENT를 검증하고 있습니다.
( 검증방식은 카드사별 상이 ) 가맹점 앱에서 USER AGENT를 임의로 변경하는 경우, 카드사
인증실패가 발생할 수 있으니 이점 유의 바랍니다.

페이지 29 / 52

Pub. Date: 2015. 01

기본적인 설치 방법

1-27.

INIpayMobile WEB 연동매뉴얼

15 <아이폰 3rd 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 ( 16.12.31 기준 )
다음

1-28.

daumapps://

네이버

naversearchapp://

크롬

googlechromes://

페이스북

fb://

카카오톡

kakaotalk://

16
주의사항 ○

삼성페이 연동 시 유의사항.

- 웹/앱 환경 공통
2 복합필드에서 안내하고 있는 신용카드 필수옵
1. 본 메뉴얼 결제창 Open(주문정보 전달) - ○
션 (twotrs_isp=Y&block_isp=Y…) 이 정상적으로 처리되어있어야합니다. 해당 옵션이 적용되어 있
지 않은 경우, 국민카드에 대해서는 비동기 처리되어, 승인결과는 노티로 전달됩니다.
2. 삼성페이 결제는 안드로이드 단말기의 삼성페이 지원 단말기에서만 사용 가능합니다.

- 앱 환경 연동 가맹점
1. 가맹점 앱에서 USER-AGENT 정보를 제어하고 있는 경우, 삼성페이가 정상적으로 실행되지
않을 수 있어, 당사에서는 가맹점 앱 내 USER-AGENT 변경을 권장하지 않고 있습니다.
2. 삼성페이 앱스키마 ( samsungpay:// ) 에 대해 가맹점 앱에서 정상 실행할 수 있도록 구현되
어 있어야 합니다. 해당 내용과 관련하여는 본 매뉴얼 아래 ispmobile:// 에 대한 예제를 참고하여
페이지 30 / 52

Pub. Date: 2015. 01

기본적인 설치 방법

INIpayMobile WEB 연동매뉴얼

samsungpay:// 스키마 호출 시에 대한 처리가 앱에서 지원되어야합니다.

페이지 31 / 52

Pub. Date: 2015. 01

앱 환경의 설치방법(안드로이드)

INIpayMobile WEB 연동매뉴얼

2. 앱 환경의 설치방법(안드로이드)
기본적인 설치방법

1-1.

안드로이드 어플리케이션 내 WebView (이하 WebView) 에서 이니페이모바일TM 을 구현하는
경우에 해당됩니다. 이니페이모바일TM 을 WebView 내에 구현하는 경우, 발생할 수 있는
Encoding Issue 는 ( 1-13. 주의사항
WebView 에서 이니페이모바일

TM

<UrlEncode issue> ) 를 참조하셔 주십시오.

을 띄우는 방식은 앞 장에서 설명한 (1.기본적인 설치 방법)

의 방법과 동일합니다. 이에 이번 장 에서는 mobileISP 앱 호출시 주의사항, 카드사 백신 앱
스키마 호출 및 “미설치 시, 앱스토어 이동 이슈” 등의 내용을 주로 다룹니다.

A. mobileISP 연동방법 - 앱 미설치 체크로직 직접구현 or 자동체크
mobileISP 앱의 기본정보는 하기와 같습니다.
Application
Scheme
Install
Url

ispmobile://
http://mobile.vpay.co.kr/jsp/MISP/andown.jsp

상기 Scheme 과 Install Url 정보로 구현가능한 안드로이드 코드는 하기와 같습니다.
1 WebViewClient 를 상속받은 클래스를 구현하시고, shouldOverrideUrlLoading() 을 호출 하
○

십시오.
private class INIP2PWebView extends WebViewClient {
@Override
public boolean shouldOverrideUrlLoading(WebView view, String url) {
….
}
2 상기 shouldOverrideUrlLoading()
○

함수

내에, try{}

catch{e}

를

통해, try

내에서는

startActivity(intent) 를 구현하시고, catch Event 발생 시, 앱 스토어로 이동할 수 있도록 조치
하시면 됩니다.
하기에 안내되는 소스는 상기 방식에 대한 Full-Source 입니다. (다음페이지)

페이지 32 / 52

Pub. Date: 2015. 01

앱 환경의 설치방법(안드로이드)

INIpayMobile WEB 연동매뉴얼

[shouldOverrideUrlLoading 부]
private class INIP2PWebView extends WebViewClient {
@Override
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();
1
○

return true;
}
}
...
return true;
}
[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() {
@Override
public void onClick(DialogInterface dialog, int which) {

페이지 33 / 52

Pub. Date: 2015. 01

앱 환경의 설치방법(안드로이드)

INIpayMobile WEB 연동매뉴얼

//ISP 설치 페이지 URL
paymentView.loadUrl("http://mobile.vpay.co.kr/jsp/MISP/andown.jsp");
finish();
}
})
.setNegativeButton("취소", new DialogInterface.OnClickListener() {
@Override
public void onClick(DialogInterface dialog, int which) {
Toast.makeText(PaymentView.this,

"(-1)결제를

취소

하셨습니다."

,

Toast.LENGTH_SHORT).show();
finish();
}
}).create();
...
}
3 mobileISP 가 단말기에 기 설치되어 있는 경우, mobileISP 가 정상구동 될 것이며,
○

4 mobileISP 가 단말기에 미 설치되어 있는 경우, 설치 후, 이니페이모바일TM 을 다시 띄워
○
1 에 대하여 true 혹은
주시면 됩니다. 23 페이지의 예시[shouldOverrideUrlLoading 부] 의 ○

false 를 설정하는 것은 하기의 표를 참고하십시요.
앱 미설치 시,
apprun_check

작동방식

앱스토어 이동 후,
결제페이지 잔존여부

Y
N or 미설정

-

ISP, 계좌이체앱, paypin
- intent 작동

상태 유지

ISP, 계좌이체앱, paypin

하기 그림1 과 같이

– appScheme 작동

Display 됨

1 true / false
○

설정
true
false

1 을 true 로 할 경우, 이니페이모바일TM 을 띄운
[shouldOverrideUrlLoading 부] 의 ○

WebView 는 사라집니다. 따라서, app Scheme 형태로 결제 앱을 호출 할 경우에는 “그림
1” 과 같이 오류 페이지가 Display 되기 때문에, WebView 를 remove 하는 것이 좋습니
다.

페이지 34 / 52

Pub. Date: 2015. 01

앱 환경의 설치방법(안드로이드)

INIpayMobile WEB 연동매뉴얼

[그림 1]
-

1 을 false 로 할 경우, 이니페이모바일TM 을 띄운
[shouldOverrideUrlLoading 부] 의 ○

WebView 는 사라지지 않기 때문에, apprun_check=Y 를 통해 현 결제 페이지가 유지되
는 방식을 사용 하는 것이 좋습니다. 이 방법을 자동체크방식이라 합니다. 단,
apprun_check 옵션을 통해 설치체크로직이 작동되므로, alertIsp 함수는 구현될 필요가 없
습니다. apprun_check 로직에 대하여 상
-

히 확인하시려면 ( 0.

결제창 Open (주문정보 전달) – 복합필드 ) 를 확인하여 주십시오. 또한, Intent 호출에 대
하여 예외처리를 반드시 체크하셔야 합니다.

B. mobileISP 연동방법 – 인증결과 전송
ISP 앱에서 인증과정이 완료되면, 다시 당사 모바일 결제창으로 돌아와서 하기의 이미지와
같이 ‘확인’ 버튼을 클릭해야, 승인과정을 시작하게 됩니다.

클릭시,
P_NEXT_URL 로 페이지 이동 (인증결과 전송)

안드로이드는 운영체제 특성 상, 현재 앱이 종료될 경우, 이 앱을 실행시킨 이전 앱이 다시
자동으로 수행됩니다. (LIFO 방식) 따라서, ISP 앱이 종료되면, 가맹점의 앱은 자동으로 다시
페이지 35 / 52

Pub. Date: 2015. 01

앱 환경의 설치방법(안드로이드)

INIpayMobile WEB 연동매뉴얼

활성화 될 것입니다.

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 {
@Override
public boolean shouldOverrideUrlLoading(WebView view, String url) {
Log.d("<INICIS_TEST>","URL : "+url);
/*
* URL별로 분기가 필요합니다. 어플리케이션을 로딩하는것과
* WEB PAGE를 로딩하는것을 분리 하여 처리해야 합니다.
* 만일 가맹점 특정 어플 URL이 들어온다면
* 조건을 더 추가하여 처리해 주십시요.
*/
if( !url.startsWith("http://") && !url.startsWith("https://")
&& !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: 2015. 01

앱 환경의 설치방법(안드로이드)

INIpayMobile WEB 연동매뉴얼

/* 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: 2015. 01

앱 환경의 설치방법(안드로이드)

INIpayMobile WEB 연동매뉴얼

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 페이지 차단
Insecurity 페이지 허용

코드
WebSettings web = paymentView.getSettings();
web.setMixedContentMode(web.MIXED_CONTENT_NEVER_ALLOW);
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: 2015. 01

앱 환경의 설치방법(IOS)

INIpayMobile WEB 연동매뉴얼

3. 앱 환경의 설치방법(IOS)
1-1.

기본적인 설치방법

IOS 어플리케이션 내 WebView (이하 WebView) 에서 이니페이모바일TM 을 구현하는 경우에
해당됩니다. 이니페이모바일TM 을 WebView 내에 구현하는 경우, 발생할 수 있는 Encoding
Issue 는 ( 1-13. 주의사항

<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 (주문정보 전달) - ②복합필드) 를 참조
부탁 드립니다. 더불어 상기 옵션 셋팅 시, 가맹점스키마명 뒤 :// 은 필수로 입력해주셔야
mobileISP 앱 종료 후 가맹점 앱이 호출 됩니다. (Ex. 가맹점 스키마명이 INIpayMobile일 경
우 app_scheme=INIpayMobile:// 로 셋팅해 주시면 됩니다.)

B. 안심클릭 결제 시, 카드사 백신 앱 연동
IOS 환경에서는 카드사에서 별도로 백신을 구동하지 않습니다.
따라서, 해당 부분은 체크하실 부분이 없습니다.

C. 카드사 앱 연동 방법
안심클릭 결제 진행에 필요한 Application (앱카드 등의) 호출이 필요할 경우 아래 샘플코드
를 참고 바랍니다.
주 문 정 보
페이지 39 / 52

(결제창 Open (주문정보 전달) – 복합필드) 내 참조
Pub. Date: 2015. 01

앱 환경의 설치방법(IOS)

INIpayMobile WEB 연동매뉴얼

앱 내 소스

하기 샘플 참조

#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: 2015. 01

앱 환경의 설치방법(IOS)

INIpayMobile WEB 연동매뉴얼

BOOL bAppScheme = [[UIApplication sharedApplication] canOpenURL:appURL];
if (!bAppScheme) {
//앱이 설치되지 않은 경우 앱스토어로 이동 또는 안내 얼럿 표출
return NO;
}
}
return YES;
}
해당 샘플은 참고용으로 각 가맹점앱에 맞게 구현하시면 됩니다.

또한, 하기의 조건을 충족하는 경우에 결제가 가능하오니, 이점 유의 바랍니다.
1 고객 단말기의 OS 버전이 4.x 이상인 경우
○
2 가맹점 Application 이 Multi switching 이 지원되는 경우
○

③ 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: 2015. 01

앱 환경의 설치방법(IOS)

E.

INIpayMobile WEB 연동매뉴얼

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를 참고하셔서 지불수단 별, 필요한 부
분사용 바랍니다.
<2015.10.05 Custom Scheme List>
지불수단

페이지 42 / 52

App

custom scheme

Pub. Date: 2015. 01

앱 환경의 설치방법(IOS)

INIpayMobile WEB 연동매뉴얼

신한 앱카드
신한 공인인증 앱
(일반결제)
현대 앱카드
현대 공인인증 앱
(일반결제)
삼성 앱카드
삼성 공인인증 앱
(일반결제)
하나 앱카드
하나 공인인증 앱
(일반결제)
농협 앱카드
농협 공인인증 앱
(일반결제)
신용카드

hdcardappcardansimclick://
smhyundaiansimclick://
mpocket.online.ansimclick://
scardcertiapp://
cloudpay://
hanaskcardmobileportal://
nhappcardansimclick://
nonghyupcardansimclick://
kb-acp://

롯데 앱카드

lotteappcard://

롯데 스마트 페이

lottesmartpay://

KPAY
ISP

citispay://

kpay://
ispmobile://

PayPin

paypin://

PAYCO

payco://

Syrup 앱카드
농협 앱카드
(올원페이)
씨티 앱카드
(2017.01.05 신규)

LPAY
카카오페이

페이지 43 / 52

smshinhanansimclick://

국민 앱카드

시티 앱카드

계좌이체

shinhan-sr-ansimclick://

tswansimclick://
nhallonepayansimclick://
citimobileapp://
lpayapp://
kakaotalk://

SSGPAY

shinsegaeeasypayment://

계좌이체

kftc-bankpay://

Pub. Date: 2015. 01

케이페이 연동방법

해외 지불수단

INIpayMobile WEB 연동매뉴얼

뱅크월렛

bankwallet://

은련카드

uppay://

4. 케이페이 연동방법
당사 간편결제 서비스인 케이페이는 영업담당자를 통해 지불수단에 추가할 수 있습니다.

1-1.

케이페이 사용 전 확인사항

케이페이는 승인결과를 노티형식으로 전송합니다. 따라서, 주문정보 중에 하나인 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: 2015. 01

케이페이 연동방법

스크린샷

INIpayMobile WEB 연동매뉴얼

Key&Value

설명

d_kpay=Y

케이페이 설치버튼이 있는 결제페이지를 노출합니다.

d_kpay=Y&

별도의 결제페이지를 노출하지 않고,

d_kpay_app=Y

즉시 케이페이를 실행합니다.

D. 케이페이 승인결과 수신방법
케이페이는 1 Transaction 방식으로 작동됩니다.
따라서, P_NOTI_URL 을 통해 승인결과를 비동기식으로 수신받습니다.
이점 유의 바랍니다.

페이지 45 / 52

Pub. Date: 2015. 01

뱅크월렛 연동방법

INIpayMobile WEB 연동매뉴얼

5. 뱅크월렛 연동방법
뱅크월렛은 계좌이체를 위한 간편결제 서비스 입니다. 기존 계좌이체 서비스를 연동 중인 가
맹점에서는 별도 수정사항 없이 뱅크월렛을 사용하실 수 있습니다. 서비스 이용 문의는 영업
담당자를 통해 진행 바랍니다.

1-1.

주의사항

현금영수증을 사용하는 경우 계좌이체와는 다르게 현금영수증 처리에 대한 별도 UI가 제공되
지 않으며 무조건 자동 발행 처리 됩니다.

1-2.

뱅크월렛 결제 Flow

[가입정보 입력]

[앱 호출 및 비밀번호 입력]

[인증처리 진행]

[결제 비밀번호 4자리 입력]

[뱅크월렛 인증처리 완료]

[승인 요청]

페이지 46 / 52

Pub. Date: 2015. 01

INIpayMobile WEB 연동매뉴얼

1-3.

뱅크월렛 바로가기

P_RESERVED (복합필드)에 뱅크월렛 바로가기 옵션을 추가할 경우 계좌이체 탭이 노출되지
않고 바로 뱅크월렛 결제 페이지로 이동합니다. 하기의 스크린샷을 참고하여 사용하시기 바
랍니다.

** P_RESERVED (복합필드) 의 경우 하나의 input에 엔드(&)을 통해 추가하는 형태를 띕니다. 기존에
P_RESERVED 옵션을 사용하고 있다면 구분자 “&”로 옵션을 추가하시면 됩니다.
양식예시 : <input type=”hidden” name=”P_RESERVED” value=”bank_receipt=N&d_kwpy=Y” />
필드명

P_RESERVED

1-4.

목

적

뱅크월렛
바로가기

Variable

d_kwpy=Y

부가설명
해당 옵션 사용 시, 계좌이체 탭을 display 하지 않고 바로
뱅크월렛 결제 페이지로 이동합니다.

뱅크월렛 승인결과 수신

뱅크월렛은 계좌이체와 동일하게 1 Transaction 방식으로 작동됩니다. 따라서 P_NOTI_URL을
통해 승인결과를 비동기식으로 수신 받습니다. P_NOTI_URL로 전달받은 승인결과 내용은 별
첨 문서인 “INIpayMobile_Receive_API_manual”를 참고 하여 주시기 바랍니다.

페이지 47 / 52

Pub. Date: 2015. 01

삼성월렛 연동방법

INIpayMobile WEB 연동매뉴얼

6. 삼성월렛 연동방법
삼성월렛을 사용하기 위해서는 영업담당자와 별도의 협의를 필요로 합니다.
또한, 삼성의 스마트폰에서만 결제가 가능한 지불수단이기 때문에, 사용자의 디바이스가 결제
불가능한 단말기일 경우(UserAgent 체크), 결제가 불가능 하도록 차단하고 있습니다.
다만, 신규 출시된 삼성 단말기의 경우, 차단될 수 있으며, 이 경우, 당사 기술지원
(ts@inicis.com) 으로 문의 바랍니다.

1-5.

삼성월렛 사용 전 확인사항

케이페이는 승인결과를 노티형식으로 전송합니다. 따라서, 주문정보 중에 하나인 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: 2015. 01

모바일 신에스크로 사용방법 안내

스크린샷

INIpayMobile WEB 연동매뉴얼

Key&Value

d_swallet=Y

설명

삼성월렛 설치버튼이 있는,
삼성월렛 결제페이지로 바로 이동합니다.

7. 모바일 신에스크로 사용방법 안내
이니페이모바일 화면에서, 신에스크로 서비스를 호출하는 옵션 입니다.
구에스크로 전용 상점 ID 는 해당 옵션을 이용하지 않더라도 에스크로로 전체 결제가
진행됩니다. 가맹점에서 거래에 따라 일반 결제와 에스크로 결제의 구분 결제를 희망하시면
신에스크로로 신규 또는 전환계약이 필요합니다. (단, 일부 호스팅 가맹점은 신 에스크로
설정에, 제한이 있을 수 있음)
또한 모바일에서 구매자의 구매결정 화면을 구성하기 희망하시면 별도의 “INIpay Mobile
에스크로 구매결정 매뉴얼”을 참조하여 주시기 바랍니다. 에스크로 계약에 문의가 있거나
자

1-1.

한 사항은 계약 담당자에게 문의하여 주시기 바랍니다.

모바일 신 에스크로 사용가능 지불수단
신용카드
계좌이체
가상계좌

A. 설정 방법
매뉴얼 결제창 Open (주문정보 전달) – 복합필드

션을 보면, P_RESERVED 파라미터 항목이

있습니다. 참고 하시어, 동일하게 상위의 옵션을 설정 하시면 됩니다.
예)
<INPUT type=”hidden” name=”P_RESERVED” value=”useescrow=Y”/>

페이지 49 / 52

Pub. Date: 2015. 01

부록

INIpayMobile WEB 연동매뉴얼

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: 2015. 01

부록

INIpayMobile WEB 연동매뉴얼

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: 2015. 01

부록

INIpayMobile WEB 연동매뉴얼

26

중국은련

32

광주

33

전북

34

하나

35

산업카드

41

NH

43

씨티

44

우리

48

신협체크

51

수협

52

제주

54

MG새마을금고체크

55

케이뱅크

56

카카오뱅크

71

우체국체크

95

저축은행체크

페이지 52 / 52

Pub. Date: 2015. 01

</pre><hr>Source Exif Data: <br /><pre>File Type                       : PDF
File Type Extension             : pdf
MIME Type                       : application/pdf
Linearized                      : No
Page Count                      : 52
PDF Version                     : 1.4
Author                          : 정기수
Producer                        : Mac OS X 10.12.6 Quartz PDFContext
Creator                         : Microsoft® Office Word 2007
Create Date                     : 2018:01:15 13:08:20Z
Modify Date                     : 2018:01:15 13:08:20Z
</pre>
<small>EXIF Metadata provided by <a href="https://exif.tools/">EXIF.tools</a></small>

<div id="ezoic-pub-ad-placeholder-110">
<script async src="//pagead2.googlesyndication.com/pagead/js/adsbygoogle.js"></script>
<!-- usermanual link ad -->
<ins class="adsbygoogle"
     style="display:block"
     data-ad-client="ca-pub-0545639743190253"
     data-ad-slot="6172135303"
     data-ad-format="link"></ins>
<script>
(adsbygoogle = window.adsbygoogle || []).push({});
</script>
</div>
</div>
				<div id="catlinks" class="catlinks catlinks-allhidden" data-mw="interface"></div>				<div class="visualClear"></div>
							</div>
		</div>
		<div id="mw-navigation">
			<h2>Navigation menu</h2>

			<div id="mw-head">
									<div id="p-personal" role="navigation" class="" aria-labelledby="p-personal-label">
                                                 <!--                              <div id="p-search" role="search">

                                                <form action="https://usermanual.wiki/search.php" id="searchform">
                                                        <div id="simpleSearch">
                                                        <input type="search" name="search" placeholder="Search UserManual.wiki" title="Search UserManual.wiki [ctrl-option-f]" accesskey="f" id="searchInput" tabindex="1" autocomplete="off"><input type="hidden" value="Special:Search" name="title"><input type="submit" name="go" value="Go" title="Find a User Manual" id="searchButton" class="searchButton">                                                 </div>
                                                </form>
                                        </div>-->
                                                <ul>
<li id="pt-mycontris"><a href="https://usermanual.wiki/upload" title="Upload User Manual" accesskey="y">Upload a User Manual</a></li>
</ul>
					</div>
									<div id="left-navigation">
										<div id="p-namespaces" role="navigation" class="vectorTabs" aria-labelledby="p-namespaces-label">
						<h3 id="p-namespaces-label">Versions of this User Manual:</h3>
						<ul>
 <li id="ca-nstab-main"><span><a href="https://usermanual.wiki/Pdf/INIpayMobileWEBmanualv432.1969719070" title="User Manual Wiki" accesskey="c">Wiki Guide</a></span></li> <li id="ca-nstab-main"><span><a href="https://usermanual.wiki/Pdf/INIpayMobileWEBmanualv432.1969719070/html" title="HTML" accesskey="c">HTML</a></span></li> <li id="ca-nstab-main"><span><a href="https://usermanual.wiki/Pdf/INIpayMobileWEBmanualv432.1969719070/amp" title="Mobile AMP" accesskey="c">Mobile</a></span></li> <li id="ca-nstab-main" class="selected" ><span><a href="https://usermanual.wiki/Pdf/INIpayMobileWEBmanualv432.1969719070/help" title="Discussion / FAQ / Help" accesskey="c">Download & Help</a></span></li>
													</ul>
					</div>
									</div>
				<div id="right-navigation">
										<div id="p-views" role="navigation" class="vectorTabs" aria-labelledby="p-views-label">
						<h3 id="p-views-label">Views</h3>
						<ul>
													
		<li id="ca-view"><span><a href="#">User Manual</a></span></li>

                                                                                                                        <li  class="selected"  id="ca-edit"><span><a href="https://usermanual.wiki/Pdf/INIpayMobileWEBmanualv432.1969719070/help" title="Ask a question" accesskey="e">Discussion / Help</a></span></li>

													</ul>
					</div>
									</div>
			</div>
			<div id="mw-panel">
				<div id="p-logo" role="banner"><a class="mw-wiki-logo" href="https://usermanual.wiki/Main_Page" title="Visit the main page"></a></div>
						<div class="portal" role="navigation" id="p-navigation" aria-labelledby="p-navigation-label">
			<h3 id="p-navigation-label">Navigation</h3>

		</div>
			<div class="portal" role="navigation" id="p-tb" aria-labelledby="p-tb-label">


		</div>
				</div>
		</div>
		<div id="footer" role="contentinfo">
							<ul id="footer-info">
											<li id="footer-info-lastmod">© 2026 UserManual.wiki</li>
									</ul>
							<ul id="footer-places">
											<li id="footer-places-privacy"><a href="https://usermanual.wiki/ContactUs" title="UserManual.wiki:Contact Us">Contact Us</a></li>
											<li id="footer-places-about"><a href="https://usermanual.wiki/DMCA" title="UserManual.wiki:DMCA">DMCA</a></li>
									</ul>
										<ul id="footer-icons" class="noprint">
											<li id="footer-poweredbyico">

</li>
									</ul>

		</div>

</div></body></html>
<script src="/cdn-cgi/scripts/7d0fa10a/cloudflare-static/rocket-loader.min.js" data-cf-settings="b1fadffa1e1cad0065598a69-|49" defer></script>